[rfc-i] RFC Style guide

Julian Reschke julian.reschke at gmx.de
Wed Jan 19 12:30:10 PST 2011


On 19.01.2011 21:06, Glenn Kowack wrote:
> Peter,
>      revising, reorganizing, and updating the Style Guide (along with the Procedures
> Manual) is called out as a priority in the TRSE (transitional RFC Series Editor)
> recommendations.  I also call out that 1) I'd like to see greater participation by
> the community in creating the style guide and 2) it may be useful to have two
> parts to the style guide: a) consisting of a small set of 'musts' that are enforced
> by the Editorial (RPC) staff, and b) a large set of guidelines, examples,  and
> recommendations.  The former will be very slow in changing and intentionally
> small; the latter will probably change with greater frequency and have more
> active community participation in its creation than would (a).
>
> Publishing the Style Guide as an RFC is an excellent idea. I'd like to see a
> discussion about that here, starting with:
>
> 	- why should the Style Guide be an RFC?

It would force the author of the style guide to work within the 
constraints it defines. Aka: "eat your own dogfood".

 > ...

Best regards, Julian

(I think the xml2rfc SoW and the "IETF Trust's Legal Provisions Relating 
to IETF Documents" fall into the same category...)


More information about the rfc-interest mailing list