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

> On 21 May 2022, at 03:14, Brian E Carpenter <brian.e.carpenter@gmail.com> wrote:
> 
> Looks good to me. I assume the RFC and BCP references will appear as links?

Yes, we have customised the page renderer in the wiki platform to do that. 

Jay

-- 
Jay Daley
IETF Executive Director 
exec-director@ietf.org
> 
> Thanks
>   Brian
> 
>> On 21-May-22 00:03, Jay Daley wrote:
>> Hi Brian
>> There’s now a Pull Request for this new content https://github.com/ietf/authors.ietf.org/pull/26 <https://github.com/ietf/authors.ietf.org/pull/26>  Please let me know if this meets your needs and anyone else please feel free to comment.
>> Jay
>>>> On 8 May 2022, at 21:54, Brian E Carpenter <brian.e.carpenter@gmail.com <mailto:brian.e.carpenter@gmail.com>> wrote:
>>> 
>>> 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 <brian.e.carpenter@gmail.com <mailto:brian.e.carpenter@gmail.com> <mailto:brian.e.carpenter@gmail.com <mailto:brian.e.carpenter@gmail.com>>> 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> <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 <brian.e.carpenter@gmail.com <mailto:brian.e.carpenter@gmail.com> <mailto:brian.e.carpenter@gmail.com <mailto:brian.e.carpenter@gmail.com>>> 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/> <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/ <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> <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 - Tools-discuss@ietf.org <mailto:Tools-discuss@ietf.org>
>>>>>>> This list is for discussion, not for action requests or bug reports.
>>>>>>> * Report datatracker and mailarchive bugs to: datatracker-project@ietf.org <mailto:datatracker-project@ietf.org>
>>>>>>> * Report tools.ietf.org <http://tools.ietf.org> bugs to: webmaster@tools.ietf.org <mailto:webmaster@tools.ietf.org>
>>>>>>> * Report all other bugs or issues to: ietf-action@ietf.org <mailto:ietf-action@ietf.org>
>>>>>>> List info (including how to Unsubscribe): https://www.ietf.org/mailman/listinfo/tools-discuss <https://www.ietf.org/mailman/listinfo/tools-discuss>
>>>>>>> 
>>>>> 
>>>> -- 
>>>> Jay Daley
>>>> IETF Executive Director
>>>> exec-director@ietf.org <mailto:exec-director@ietf.org> <mailto:exec-director@ietf.org <mailto:exec-director@ietf.org>>
>>> <desirable.md>
>> -- 
>> Jay Daley
>> IETF Executive Director
>> exec-director@ietf.org <mailto:exec-director@ietf.org>
> 