The following describes the procedures and work environment used for editing the SPF project's RFC documents.
The Document XML Source
Before publication by the IETF, the authoritative instance of an RFC document is its XML source code. The format and XML DTD for writing such XML source documents is described in RFC 2629bis.
The XML source can then be converted to plain text (.txt) or HTML (.html) formats using the xml2rfc tool (stable version) (README). There is also an experimental pre-release version (README) if you want to be on the bleeding edge.
An XSLT processor and the rfc2629.xslt stylesheet, too, can be used to transform the XML source to other formats, including HTML and PDF.
Example: See rfc4408.xml for an example of an XML source document. rfc4408.txt and rfc4408.html have been generated from it using xml2rfc.
Editing Tools
- rfcdiff
- Find differences between plain-text formatted document versions and output the differences in various nice formats.
- IETF RFC Tools
- The IETF has a few other tools that might be useful for editing RFC documents.
Revision Control Repository
The SPF project maintains its RFC drafts and finalized documents in a Subversion repository. (Every document has a master editor who is responsible for it and who must be contacted before changes are made.)