[rfc-i] RFC Style guide
julian.reschke at gmx.de
Wed Jan 19 12:30:10 PST 2011
On 19.01.2011 21:06, Glenn Kowack wrote:
> 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