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

[Brian E Carpenter <[e-mail]>]

Jay,

Here's a short markdown file. I borrowed some text directly from the RFCs 
invoked.

Regards
    Brian

On 04-May-22 05:08, Jay Daley wrote:
> 
>> On 2 May 2022, at 23:17, Brian E Carpenter <[e-mail] <mailto:[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] <mailto:[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/ <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 <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] <mailto:[e-mail]>
>