RE: WG Document Shepherd Write-Up Template: 2nd call for review (Ends 05/06/2026)

[[e-mail]]

Hi Mark, 

Thanks for the feedback. 

Made changes with that in mind: https://github.com/IETF-OPS-AD/misc/issues/40.

Cheers,
Med

> -----Message d'origine-----
> De : Mark Nottingham <[e-mail]>
> Envoyé : vendredi 29 mai 2026 22:31
> À : BOUCADAIR Mohamed INNOV/NET <[e-mail]>
> Cc : WG Chairs <[e-mail]>
> Objet : Re: WG Document Shepherd Write-Up Template: 2nd call for
> review (Ends 05/06/2026)
> 
> 
> Hi Med,
> 
> Could you please consider the issues I raised? I realise I missed
> the first deadline by a couple of days.
> 
> Thanks,
> 
> 
> > On 29 May 2026, at 10:55 pm, [e-mail] wrote:
> >
> > Hi all,
> >  Thank you for the discussion, comments, and suggestions.
> >  Received comments are grouped and tracked at:
> https://fra01.safelinks.protection.outlook.com/?url=https%3A%2F%2F
> github.com%2FIETF-OPS-
> AD%2Fmisc%2Fissues&data=05%7C02%7Cmohamed.boucadair%40orange.com%7
> C18cfa7c58e9b4053f33908debdc14229%7C90c7a20af34b40bfbc48b9253b6f5d
> 20%7C0%7C0%7C639156834924781917%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU
> 1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIs
> IldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=Xtja0h%2BRgBnQ9NDbYFYT4omHXgx%
> 2FNflSf0zsuj9qu7s%3D&reserved=0. The following labels are used:
> >     • has-PR: A PR is created to address the comment.
> >     • candidate-future-tool-enhancement: for comments that
> require datatracker changes.
> >     • Candidate-WG-Chairs-Action: for comments that are better
> addressed by WG Chairs action, rather than a change to the
> writeup.
> >     • Related-Datatracker-Issue-Exists: for comments for which a
> ticket is already filed such as (WG charter compliance document
> adoption gate · Issue #7955 · ietf-tools/datatracker).
> >     • Wontfix: the reasoning is provided for each of these
> issues.
> >  Proposed changes can be found here:
> https://fra01.safelinks.protection.outlook.com/?url=https%3A%2F%2F
> github.com%2FIETF-OPS-
> AD%2Fmisc%2Fpulls&data=05%7C02%7Cmohamed.boucadair%40orange.com%7C
> 18cfa7c58e9b4053f33908debdc14229%7C90c7a20af34b40bfbc48b9253b6f5d2
> 0%7C0%7C0%7C639156834924804442%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1
> hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsI
> ldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=8lJnAgMc%2BYtK4vxTWPpE%2BHTymap
> 8MDJzSzY0YVNMY0s%3D&reserved=0. Each PR is linked to the relevant
> issue.
> >  For convenience, a rendered version with all proposed changes
> > implemented can be found
> >
> here:https://fra01.safelinks.protection.outlook.com/?url=https%3A%
> 2F%2
> > Fgithub.com%2FIETF-OPS-
> AD%2Fmisc%2Fblob%2Fmain%2Fdocument%2520writeup%
> > 2520template%2Frevised-writeup-after-wgchairs-
> review.md&data=05%7C02%7
> >
> Cmohamed.boucadair%40orange.com%7C18cfa7c58e9b4053f33908debdc14229
> %7C9
> >
> 0c7a20af34b40bfbc48b9253b6f5d20%7C0%7C0%7C639156834924817311%7CUnk
> nown
> >
> %7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJ
> XaW4
> >
> zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=nFCLO9oYq
> BZrZ
> > 5PxKkY4Tm2EuJVosAw6tb6RwaLzZes%3D&reserved=0. You may also use
> this
> > diff to track the changes:
> >
> https://fra01.safelinks.protection.outlook.com/?url=https%3A%2F%2F
> gith
> > ub.com%2FIETF-OPS-
> AD%2Fmisc%2Fblob%2Fmain%2Fdocument%2520writeup%2520t
> > emplate%2Fdiff-after-WGChairs-review-
> 29052026.pdf&data=05%7C02%7Cmoham
> >
> ed.boucadair%40orange.com%7C18cfa7c58e9b4053f33908debdc14229%7C90c
> 7a20
> >
> af34b40bfbc48b9253b6f5d20%7C0%7C0%7C639156834924827906%7CUnknown%7
> CTWF
> >
> pbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zM
> iIsI
> >
> kFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=mIBiBUWMoWb7%2F
> YOUX
> > 4%2F2BG3b75mQCpPHs4s%2FLgVOcEE%3D&reserved=0
> >  We are opening a 1-week review period for the proposed changes
> (Ends 05/06/2026). Feel free to raise any further comment you have
> by then, either by email or in github.
> >  Cheers,
> > Med
> >  De : BOUCADAIR Mohamed INNOV/NET
> > Envoyé : dimanche 3 mai 2026 11:31
> > À : WG Chairs <[e-mail]>
> > Objet : WG Document Shepherd Write-Up Template: Call for review
> (Ends
> > 22/05/2026)  Hi all,  The IESG is considering an update of the
> WG
> > document writeup template to take into account the experience
> with the template so far. Overall, the proposed changes fall under
> the following categories: clarify some questions that are vague,
> update questions that include stale guidance or not aligned with
> our process, simplify some questions and soften the load on the
> shepherd, and add few questions to help flag and fix early in the
> process some aspects that are recurrently subject to DISCUSS
> ballots. The proposed changes can be better tracked by checking
> the following links:
> >
> >     • Draft update (05/2026):
> https://fra01.safelinks.protection.outlook.com/?url=https%3A%2F%2F
> github.com%2FIETF-OPS-
> AD%2Fmisc%2Fblob%2Fmain%2Fdocument%2520writeup%2520template%2Fdocu
> ment-shepherd-writeup-wg-
> documents.md&data=05%7C02%7Cmohamed.boucadair%40orange.com%7C18cfa
> 7c58e9b4053f33908debdc14229%7C90c7a20af34b40bfbc48b9253b6f5d20%7C0
> %7C0%7C639156834924839528%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGki
> OnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIj
> oyfQ%3D%3D%7C0%7C%7C%7C&sdata=pJZn7LrU06qMX%2BxbS7ZuCwhaZAGJVsvQkj
> 6cRWx6nj4%3D&reserved=0
> >     • Current version (2022):
> https://fra01.safelinks.protection.outlook.com/?url=https%3A%2F%2F
> datatracker.ietf.org%2Fdoc%2Fshepherdwriteup-
> template%2Fworkinggroup&data=05%7C02%7Cmohamed.boucadair%40orange.
> com%7C18cfa7c58e9b4053f33908debdc14229%7C90c7a20af34b40bfbc48b9253
> b6f5d20%7C0%7C0%7C639156834924853538%7CUnknown%7CTWFpbGZsb3d8eyJFb
> XB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWF
> pbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=KPnIUz3Pho%2B6ZffyLrKOHQB
> kA9JbeGMPpuEjVc6l6pk%3D&reserved=0
> >     • Diff between old/proposed:
> >
> https://fra01.safelinks.protection.outlook.com/?url=https%3A%2F%2F
> gith
> > ub.com%2FIETF-OPS-
> AD%2Fmisc%2Fblob%2Fmain%2Fdocument%2520writeup%2520t
> > emplate%2Fwriteup-
> diff.pdf&data=05%7C02%7Cmohamed.boucadair%40orange.c
> >
> om%7C18cfa7c58e9b4053f33908debdc14229%7C90c7a20af34b40bfbc48b9253b
> 6f5d
> >
> 20%7C0%7C0%7C639156834924864191%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU
> 1hcG
> >
> kiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldU
> Ijoy
> >
> fQ%3D%3D%7C0%7C%7C%7C&sdata=uUgEcGeKteIzTqdKZ3qQ2B5Ye%2BodIjD3lvHU
> pnVp
> > svs%3D&reserved=0  As a WG Chair, it is likely that you
> shepherded
> > yourself a document or helped a non-‘WG Chair’ shepherd (*)
> complete a writeup. Your experience and perspective are thus
> important to help the IESG in preparing this revision.
> >  We are interested to hear your feedback about the template in
> general, whether the load to complete it is acceptable, whether
> there are questions that lack clarity, there are missing
> questions, or there are questions that you think can be removed
> because of some reason. Suggestions and proposals are more than
> welcome.
> >  Feel free to raise your comments/suggestions by email or as
> github issue by 22/05/2026.
> >  Thank you.
> >  Cheers,
> > Med
> >  (*) A call for review/feedback will also be sent to a pool of
> recent document non-‘WG Chair’ shepherds.
> >
> __________________________________________________________________
> ____
> > ______________________________________
> > Ce message et ses pieces jointes peuvent contenir des
> informations
> > confidentielles ou privilegiees et ne doivent donc pas etre
> diffuses,
> > exploites ou copies sans autorisation. Si vous avez recu ce
> message
> > par erreur, veuillez le signaler a l'expediteur et le detruire
> ainsi que les pieces jointes. Les messages electroniques etant
> susceptibles d'alteration, Orange decline toute responsabilite si
> ce message a ete altere, deforme ou falsifie. Merci.
> >
> > This message and its attachments may contain confidential or
> > privileged information that may be protected by law; they should
> not be distributed, used or copied without authorisation.
> > If you have received this email in error, please notify the
> sender and delete this message and its attachments.
> > As emails may be altered, Orange is not liable for messages that
> have been modified, changed or falsified.
> > Thank you.
> 
> --
> Mark Nottingham
> https://fra01.safelinks.protection.outlook.com/?url=https%3A%2F%2F
> www.mnot.net%2F&data=05%7C02%7Cmohamed.boucadair%40orange.com%7C18
> cfa7c58e9b4053f33908debdc14229%7C90c7a20af34b40bfbc48b9253b6f5d20%
> 7C0%7C0%7C639156834924874350%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hc
> GkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIld
> UIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=LJ9kdMcpH4Ef45Kwgsnn%2Blognphg1DZ
> 3l7VTmskEfsU%3D&reserved=0

____________________________________________________________________________________________________________
Ce message et ses pieces jointes peuvent contenir des informations confidentielles ou privilegiees et ne doivent donc
pas etre diffuses, exploites ou copies sans autorisation. Si vous avez recu ce message par erreur, veuillez le signaler
a l'expediteur et le detruire ainsi que les pieces jointes. Les messages electroniques etant susceptibles d'alteration,
Orange decline toute responsabilite si ce message a ete altere, deforme ou falsifie. Merci.

This message and its attachments may contain confidential or privileged information that may be protected by law;
they should not be distributed, used or copied without authorisation.
If you have received this email in error, please notify the sender and delete this message and its attachments.
As emails may be altered, Orange is not liable for messages that have been modified, changed or falsified.
Thank you.