Re: [Tools-discuss] Missing stuff in author tools Content Guide

[Jay Daley <[e-mail]>]

> On 2 May 2022, at 23:17, Brian E Carpenter <[e-mail]> wrote:
> 
> Thanks Jay. Might I suggest a separate heading, though? I would never have expected this to be under "Language and style", which is why I didn't find it.

Yes I agree.  When putting this site together there was some strong pushback to having short pages but in this case I think it is needed.  I will create an "Example Addresses" page with the existing text moved over. That’s strictly adhering to how the last I-D guidelines had it.

> 
> While I'm here, could we also mention the (optional) Implementation Status Section (BCP205/RFC7942)? This is underused but very desirable, so maybe the "Required content" section could be renamed "Required and desirable content".
> 
> Similarly, I see no mention of (optional) Privacy Considerations as suggested by RFC6973.

In both cases could you please suggest some text?

BTW the old I-D Guidelines can be more easily found at https://github.com/ietf/id-guidelines <https://github.com/ietf/id-guidelines>

Jay

> 
> Regards
>   Brian
> 
> On 02-May-22 21:02, Jay Daley wrote:
>>> On 30 Apr 2022, at 06:10, Brian E Carpenter <[e-mail]> wrote:
>>> 
>>> Hi,
>>> 
>>> I needed to remind myself of the range of documentation addresses, so I clicked on the old link for that:
>>> https://www.ietf.org/standards/ids/checklist/
>>> 
>>> Oh dear, it redirected me to the generic author tools page. So I looked around for the I-D checklist and couldn't find it. I did find the "Content guide" menu but couldn't find what I needed.
>>> 
>>> I eventually found it at:
>>> https://web.archive.org/web/20210512111059/https://www.ietf.org/standards/ids/checklist/
>>> 
>>> There seems to be a chunk of the material at the bottom of "3. Content Issues" that has gone missing, unless I have somehow overlooked it: Bullet 6, with the recommendations for documentation IP addresses (and telephone numbers). It's still important to use these (and I assume idnits still checks).
>> https://authors.ietf.org/en/language-and-style#example-addresses
>> JaY
>>> 
>>> (Nit in the original: 2001:DB8::/32 should be 2001:db8::/32 these days.)
>>> Regards
>>>   Brian
>>> 
>>> ___________________________________________________________
>>> Tools-discuss mailing list - [e-mail]
>>> This list is for discussion, not for action requests or bug reports.
>>> * Report datatracker and mailarchive bugs to: [e-mail]
>>> * Report tools.ietf.org bugs to: [e-mail]
>>> * Report all other bugs or issues to: [e-mail]
>>> List info (including how to Unsubscribe): https://www.ietf.org/mailman/listinfo/tools-discuss
>>> 
> 

-- 
Jay Daley
IETF Executive Director
[e-mail]