| < draft-iab-streams-headers-boilerplates-00.txt | draft-iab-streams-headers-boilerplates-01.txt > | |||
|---|---|---|---|---|
| Network Working Group L. Daigle, Ed. | Network Working Group L. Daigle, Ed. | |||
| Internet-Draft | Internet-Draft O. Kolkman, Ed. | |||
| Intended status: BCP O. Kolkman, Ed. | Updates: 4844, 2223 | |||
| Expires: December 29, 2008 Internet Architecture Board | (if approved) Internet Architecture Board | |||
| (IAB) | Intended status: Informational (IAB) | |||
| June 27, 2008 | Expires: April 9, 2009 October 6, 2008 | |||
| On RFC Streams Headers and Boilerplates | On RFC Streams, Headers, and Boilerplates | |||
| draft-iab-streams-headers-boilerplates-00 | draft-iab-streams-headers-boilerplates-01 | |||
| Status of this Memo | Status of this Memo | |||
| By submitting this Internet-Draft, each author represents that any | By submitting this Internet-Draft, each author represents that any | |||
| applicable patent or other IPR claims of which he or she is aware | applicable patent or other IPR claims of which he or she is aware | |||
| have been or will be disclosed, and any of which he or she becomes | have been or will be disclosed, and any of which he or she becomes | |||
| aware will be disclosed, in accordance with Section 6 of BCP 79. | aware will be disclosed, in accordance with Section 6 of BCP 79. | |||
| Internet-Drafts are working documents of the Internet Engineering | Internet-Drafts are working documents of the Internet Engineering | |||
| Task Force (IETF), its areas, and its working groups. Note that | Task Force (IETF), its areas, and its working groups. Note that | |||
| skipping to change at page 1, line 36 ¶ | skipping to change at page 1, line 36 ¶ | |||
| and may be updated, replaced, or obsoleted by other documents at any | and may be updated, replaced, or obsoleted by other documents at any | |||
| time. It is inappropriate to use Internet-Drafts as reference | time. It is inappropriate to use Internet-Drafts as reference | |||
| material or to cite them other than as "work in progress." | material or to cite them other than as "work in progress." | |||
| The list of current Internet-Drafts can be accessed at | The list of current Internet-Drafts can be accessed at | |||
| http://www.ietf.org/ietf/1id-abstracts.txt. | http://www.ietf.org/ietf/1id-abstracts.txt. | |||
| The list of Internet-Draft Shadow Directories can be accessed at | The list of Internet-Draft Shadow Directories can be accessed at | |||
| http://www.ietf.org/shadow.html. | http://www.ietf.org/shadow.html. | |||
| This Internet-Draft will expire on December 29, 2008. | This Internet-Draft will expire on April 9, 2009. | |||
| Abstract | Abstract | |||
| RFC documents contain a number of fixed elements such as the title | RFC documents contain a number of fixed elements such as the title | |||
| page header, standard boilerplates and a standard acknowledgement | page header, standard boilerplates and copyright/IPR statements. | |||
| section. This document describes them and introduces some updates to | This document describes them and introduces some updates to reflect | |||
| reflect current usage and requirements of RFC publication. In | current usage and requirements of RFC publication. In particular, | |||
| particular, this updated structure is intended to communicate clearly | this updated structure is intended to communicate clearly the source | |||
| the source of RFC creation and review. | of RFC creation and review. | |||
| Table of Contents | Table of Contents | |||
| 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3 | 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3 | |||
| 2. RFC Streams and Internet Standards . . . . . . . . . . . . . . 3 | 2. RFC Streams and Internet Standards . . . . . . . . . . . . . . 3 | |||
| 3. RFC Structural Elements . . . . . . . . . . . . . . . . . . . 4 | 3. RFC Structural Elements . . . . . . . . . . . . . . . . . . . 4 | |||
| 3.1. The title page header . . . . . . . . . . . . . . . . . . 4 | 3.1. The title page header . . . . . . . . . . . . . . . . . . 4 | |||
| 3.2. The Status of this Memo . . . . . . . . . . . . . . . . . 6 | 3.2. The Status of this Memo . . . . . . . . . . . . . . . . . 6 | |||
| 3.3. Additional Notes . . . . . . . . . . . . . . . . . . . . . 8 | 3.3. Additional Notes . . . . . . . . . . . . . . . . . . . . . 8 | |||
| 4. Security considerations . . . . . . . . . . . . . . . . . . . 8 | 3.4. Other structural information in RFCs . . . . . . . . . . . 8 | |||
| 5. IANA considerations . . . . . . . . . . . . . . . . . . . . . 8 | 4. Security considerations . . . . . . . . . . . . . . . . . . . 9 | |||
| 6. RFC Editor Considerations . . . . . . . . . . . . . . . . . . 8 | 5. IANA considerations . . . . . . . . . . . . . . . . . . . . . 9 | |||
| 7. References . . . . . . . . . . . . . . . . . . . . . . . . . . 8 | 6. RFC Editor Considerations . . . . . . . . . . . . . . . . . . 9 | |||
| 7.1. Normative References . . . . . . . . . . . . . . . . . . . 8 | 7. References . . . . . . . . . . . . . . . . . . . . . . . . . . 9 | |||
| 7.2. Informative References . . . . . . . . . . . . . . . . . . 9 | 7.1. Normative References . . . . . . . . . . . . . . . . . . . 9 | |||
| Appendix A. Acknowledgements . . . . . . . . . . . . . . . . . . 9 | 7.2. Informative References . . . . . . . . . . . . . . . . . . 10 | |||
| Appendix B. Document Editing Details . . . . . . . . . . . . . . 9 | Appendix A. Acknowledgements . . . . . . . . . . . . . . . . . . 10 | |||
| Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 9 | Appendix B. Document Editing Details . . . . . . . . . . . . . . 10 | |||
| Intellectual Property and Copyright Statements . . . . . . . . . . 11 | B.1. version 00->01 . . . . . . . . . . . . . . . . . . . . . . 11 | |||
| B.1.1. open issues . . . . . . . . . . . . . . . . . . . . . 11 | ||||
| Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 11 | ||||
| Intellectual Property and Copyright Statements . . . . . . . . . . 13 | ||||
| 1. Introduction | 1. Introduction | |||
| RFCs published before this document (e.g. the one immeditatly prior | Previously RFCs (e.g. [RFC4844]) contained a number of elements that | |||
| to this one [RFCXXXX-1]) (??? or is it prior to approval of this | were there for historical, practical, and legal reasons. They also | |||
| document?) contained a number of elements that were there for | contained boilerplate material to clearly indicate the status of the | |||
| historical, practical, and legal reasons. They also contained | document and possibly contained "Notes" to indicate how the document | |||
| boilerplate material to clearly indicate the status of the document | interacts with IETF standard track documents. | |||
| and possibly contained "Notes" to indicate how the document interacts | ||||
| with IETF standard track documents. | ||||
| As the RFC Series has evolved over the years, there has been | As the RFC Series has evolved over the years, there has been | |||
| increasing concern over appropriate labelling of the publications to | increasing concern over appropriate labelling of the publications to | |||
| make clear the status of each RFC and the status of the work it | make clear the status of each RFC and the status of the work it | |||
| describes. Chiefly, there is a requirement that RFCs published as | describes. Chiefly, there is a requirement that RFCs published as | |||
| part of the IETF's review process not be easily confused with RFCs | part of the IETF's review process not be easily confused with RFCs | |||
| that may have had a very different review and approval process. | that may have had a very different review and approval process. | |||
| Various adjustments have been made over the years, including evolving | Various adjustments have been made over the years, including evolving | |||
| text of "Notes" included in the published RFC. | text of "Notes" included in the published RFC. | |||
| skipping to change at page 3, line 36 ¶ | skipping to change at page 3, line 34 ¶ | |||
| standard RFC boilerplate and introduce some adjustments to ensure | standard RFC boilerplate and introduce some adjustments to ensure | |||
| better clarity of expression of document status, aligned with the | better clarity of expression of document status, aligned with the | |||
| review and approval processes defined for each stream. | review and approval processes defined for each stream. | |||
| This memo identifies and describes the common elements of RFC | This memo identifies and describes the common elements of RFC | |||
| boilerplate structure, and provides a comprehensive approach to | boilerplate structure, and provides a comprehensive approach to | |||
| updating and using those elements to communicate, with clarity, RFC | updating and using those elements to communicate, with clarity, RFC | |||
| document and content status. Most of the historical structure | document and content status. Most of the historical structure | |||
| information is collected from [RFC2223]. | information is collected from [RFC2223]. | |||
| The changes introduced by this memo should be implemented as soon as | ||||
| practically possible after the document has been approved for | ||||
| publication. | ||||
| 2. RFC Streams and Internet Standards | 2. RFC Streams and Internet Standards | |||
| Users of RFCs should be aware that while all Internet standards- | Users of RFCs should be aware that while all Internet standards- | |||
| related documents are published as RFCs, not all RFCs are Internet | related documents are published as RFCs, not all RFCs are Internet | |||
| standards-related documents. | standards-related documents. | |||
| The IETF is responsible for maintaining the Internet Standards | The IETF is responsible for maintaining the Internet Standards | |||
| Process, which includes the requirements for developing, reviewing | Process, which includes the requirements for developing, reviewing | |||
| and approving Standards Track and BCP RFCs. These, and any other | and approving Standards Track and BCP RFCs. These, and any other | |||
| standards-related documents (Informational or Experimental) are | standards-related documents (Informational or Experimental) are | |||
| skipping to change at page 4, line 9 ¶ | skipping to change at page 4, line 11 ¶ | |||
| Stream. | Stream. | |||
| Documents published in streams other than the IETF Stream are not | Documents published in streams other than the IETF Stream are not | |||
| reviewed by the IETF for such things as security, congestion control, | reviewed by the IETF for such things as security, congestion control, | |||
| or inappropriate interaction with deployed protocols. They have also | or inappropriate interaction with deployed protocols. They have also | |||
| not been subject to IESG approval, including an IETF-wide last call. | not been subject to IESG approval, including an IETF-wide last call. | |||
| Therefore, the IETF disclaims, for any of the non-IETF Stream | Therefore, the IETF disclaims, for any of the non-IETF Stream | |||
| documents, any knowledge of the fitness of those RFCs for any | documents, any knowledge of the fitness of those RFCs for any | |||
| purpose. | purpose. | |||
| Refer to [RFC2026] and [RFC4844] and their succession for current | Refer to [RFC2026], [I-D.housley-iesg-rfc3932bis], and [RFC4844] and | |||
| detail of IETF process and RFCs streams. | their successors for current details of IETF process and RFC streams. | |||
| 3. RFC Structural Elements | 3. RFC Structural Elements | |||
| 3.1. The title page header | 3.1. The title page header | |||
| An RFC title page header can be described as follows: | An RFC title page header can be described as follows: | |||
| ------------------------------------------------------------------------ | ------------------------------------------------------------------------ | |||
| <document source> <author name> | <document source> <author name> | |||
| Request for Comments: <RFC number> <author affiliation> | Request for Comments: <RFC number> [<author affiliation>] | |||
| [<subseries ID> <subseries number>] [more author info as appropriate] | [<subseries ID> <subseries number>] [more author info as appropriate] | |||
| [<RFC relation>:<RFC number[s]>] | [<RFC relation>:<RFC number[s]>] | |||
| Category: <category> | Category: <category> | |||
| ISSN: [TBD] <month year> | <month year> | |||
| ------------------------------------------------------------------------ | ------------------------------------------------------------------------ | |||
| For example, a sample earlier RFC header is as follows: | For example, a sample earlier RFC header is as follows: | |||
| ------------------------------------------------------------------------ | ------------------------------------------------------------------------ | |||
| Network Working Group T. Dierks | Network Working Group T. Dierks | |||
| Request for Comments: 4346 Independent | Request for Comments: 4346 Independent | |||
| Obsoletes: 2246 E. Rescorla | Obsoletes: 2246 E. Rescorla | |||
| Category: Standards Track RTFM, Inc. | Category: Standards Track RTFM, Inc. | |||
| April 2006 | April 2006 | |||
| ------------------------------------------------------------------------ | ------------------------------------------------------------------------ | |||
| The right column contains author name and affiliation information as | The right column contains author name and affiliation information as | |||
| well as RFC publication date. Conventions and restrictions for these | well as RFC publication date. Conventions and restrictions for these | |||
| elements are described in RFC style norms and some individual stream | elements are described in RFC style norms and some individual stream | |||
| definitions. | definitions. | |||
| This memo is primarily concerned with the information in left column: | This section is primarily concerned with the information in the left | |||
| column: | ||||
| <document source> This describes the area where the work originates. | <document source> This describes the area where the work originates. | |||
| Historically, all RFCs were labeled Network Working Group. | Historically, all RFCs were labeled Network Working Group. | |||
| "Network Working Group" refers to the original version of today's | "Network Working Group" refers to the original version of today's | |||
| IETF when people from the original set of Arpanet sites and | IETF when people from the original set of ARPANET sites and | |||
| whomever else was interested -- the meetings were open -- got | whomever else was interested -- the meetings were open -- got | |||
| together to discuss, design and document proposed protocols.' | together to discuss, design and document proposed | |||
| [Steve Crocker, private communication]. Here, we obsolete the | protocols[RFC0003]. Here, we obsolete the term "Network Working | |||
| term "Network Working Group" in order to indicate the originating | Group" in order to indicate the originating stream. | |||
| stream. | ||||
| The <document source> is the name of the RFC stream, as defined in | The <document source> is the name of the RFC stream, as defined in | |||
| [RFC4844] and its successors. At the time of this publication, | [RFC4844] and its successors. At the time of this publication, | |||
| the streams, and therefore the possible entries are: | the streams, and therefore the possible entries are: | |||
| * IETF Stream | * Internet Engineering Task Force | |||
| * IAB Stream | * Internet Architecture Board | |||
| * IRTF Stream | * Internet Research Task Force | |||
| * Independent Stream | * Independent | |||
| Request for Comments: <RFC number> This indicates the RFC number, | Request for Comments: <RFC number> This indicates the RFC number, | |||
| assigned by the RFC Editor upon publication of the document. This | assigned by the RFC Editor upon publication of the document. This | |||
| element is unchanged. | element is unchanged. | |||
| <subseries ID> <subseries number> Some document categories are also | <subseries ID> <subseries number> Some document categories are also | |||
| labeled as a subseries of RFCs. These elements appear as | labeled as a subseries of RFCs. These elements appear as | |||
| appropriate for such categories, indicating the subseries and the | appropriate for such categories, indicating the subseries and the | |||
| documents number within that series. Currently, there are | documents number within that series. Currently, there are | |||
| subseries for BCPs, STDs and FYIs. These subseries numbers may | subseries for BCPs, STDs and FYIs. These subseries numbers may | |||
| appear in several RFCs. For example, when a new RFC updates an | appear in several RFCs. For example, when a new RFC updates an | |||
| old one, the same subseries number is used. Also, several RFCs | old one, the same subseries number is used. Also, several RFCs | |||
| may be assigned the same subseries number: a single STD, for | may be assigned the same subseries number: a single STD, for | |||
| example, may be composed of several RFCs, each of which will bear | example, may be composed of several RFCs, each of which will bear | |||
| the same STD number. This element is unchanged. | the same STD number. This element is unchanged. | |||
| [<RFC relation>:<RFC number[s]>] Some relations between RFCs in the | [<RFC relation>:<RFC number[s]>] Some relations between RFCs in the | |||
| series are explicitly noted in the RFC header. For example, a new | series are explicitly noted in the RFC header. For example, a new | |||
| RFC may update one or more earlier RFCs. Current relationships | RFC may update one or more earlier RFCs. Currently two | |||
| are "Updates" and "Obsoletes". This document introduces the new | relationships are defined "Updates" and "Obsoletes". Other types | |||
| relation "Clarifies" which can be used when a new RFC updates a | of relations may be defined elsewhere. | |||
| previous RFC without making any normative changes. | ||||
| Category: <category> This indicates the RFC document category of the | Category: <category> This indicates the RFC document category of the | |||
| publication. These are defined in [RFC2026]. Currently, this is | publication. These are defined in [RFC2026]. Currently, this is | |||
| always one of: Standards Track, Best Current Practice, | always one of: Standards Track, Best Current Practice, | |||
| Experimental, Informational, or Historic. This element is | Experimental, Informational, or Historic. This element is | |||
| unchanged. | unchanged. | |||
| The ISSN number is the International Standard Serial | ||||
| Number[ISO3297]. Once such number has been assigned to the RFC | ||||
| series this element will appear here. | ||||
| 3.2. The Status of this Memo | 3.2. The Status of this Memo | |||
| The "Status of This Memo" describes the category of the RFC, | The "Status of This Memo" describes the category of the RFC, | |||
| including the distribution statement. This text is included | including the distribution statement. This text is included | |||
| irrespective of the source stream of the RFC. | irrespective of the source stream of the RFC. | |||
| Going forward, the "Status of This Memo" will start with a single | From now on, the "Status of This Memo" will start with a single line | |||
| line describing the status. It will also include a statement | describing the status. It will also include a statement describing | |||
| describing the the stream-specific review of the material (which is | the stream-specific review of the material (which is stream- | |||
| stream-dependent). This is an important component of status, insofar | dependent). This is an important component of status, insofar as it | |||
| as it clarifies the breadth and depth of review, and gives the reader | clarifies the breadth and depth of review, and gives the reader an | |||
| an understanding of how to consider its content. | understanding of how to consider its content. | |||
| The first paragraph of the Status of this Memo section contains a | The first paragraph of the Status of this Memo section contains a | |||
| single line. It depends on the category of the document. | single line, clearly standing out. It depends on the category of the | |||
| document. | ||||
| This memo is an Internet Standards Track document. | This memo is an Internet Standards Track document. | |||
| This memo is documents a Best Current Practice | This memo documents an Internet Best Current Practice | |||
| This memo is not an Internet Standard Track specification, it is | This memo is not an Internet Standards Track specifiation, <it is | |||
| published for Informational purposes. | published for other purposes>. | |||
| The second paragraph contains the current text [RFC2223] describing | For Informational, Experimental and other future categories of RFC | |||
| categories is as follows: | editor will maintain an appropriate text for <it is published for | |||
| other purposes>. For example, with an Informational document this | ||||
| could read "It is published for informational purposes". | ||||
| This indicates the RFC number, assigned by the RFC Editor upon | ||||
| publication of the document. This element is unchanged. | ||||
| The second paragraph contains category-specific text as follows: | ||||
| Standards Track: "This document specifies an Internet standards | Standards Track: "This document specifies an Internet standards | |||
| track protocol for the Internet community, and requests discussion | track protocol for the Internet community. Please see the | |||
| and suggestions for improvements. Please refer to the current | "Updates to the RFC" section of this document for information on | |||
| edition of the "Internet Official Protocol Standards" (STD 1) for | where to find the status of this protocol and the availability of | |||
| the standardization state and status of this protocol. | errata for this memo." | |||
| Distribution of this memo is unlimited." | ||||
| Best Current Practice: "This document specifies an Internet Best | Best Current Practice: "This document specifies an Internet Best | |||
| Current Practices for the Internet Community, and requests | Current Practices for the Internet Community. Please see the | |||
| discussion and suggestions for improvements. Distribution of this | "Updates to the RFC" section of this document for information on | |||
| memo is unlimited." | where to find the status of this protocol and the availability of | |||
| errata for this memo." | ||||
| Experimental: "This memo defines an Experimental Protocol for the | Experimental: "This memo defines an Experimental Protocol for the | |||
| Internet community. This memo does not specify an Internet | Internet community. This memo does not specify an Internet | |||
| standard of any kind. Discussion and suggestions for improvement | standard of any kind. Discussion and suggestions for improvement | |||
| are requested. Distribution of this memo is unlimited." | are requested." | |||
| Informational: "This memo provides information for the Internet | Informational: "This memo provides information for the Internet | |||
| community. This memo does not specify an Internet standard of any | community. This memo does not specify an Internet standard of any | |||
| kind. Distribution of this memo is unlimited." | kind. " | |||
| The third paragraph of the "Status of This Memo" will now include a | The third paragraph of the "Status of This Memo" will now include a | |||
| paragraph describing the type of review and exposure the document has | paragraph describing the type of review and exposure the document has | |||
| received. This is defined on a per-stream basis. Going forward, | received. This is defined on a per-stream basis. From now on, these | |||
| these paragraphs will be defined as part of RFC stream definition. | paragraphs will be defined as part of RFC stream definition. | |||
| Initial paragraphs for the existing streams are: | The following texts may be updated if the stream definitions are | |||
| updated, but initial paragraphs for the existing streams are: | ||||
| IETF Stream: "This document is a product of the Internet Engineering | IETF Stream: "This document is a product of the Internet Engineering | |||
| Task Force (IETF). Per the IETF's specification process, this | Task Force (IETF). " | |||
| document represents a consensus of the IETF community. It has | ||||
| received public review and has been approved for publication by | If there has been an IETF consensus call per IETF process, an | |||
| the IESG." | additional sentence should be added: "This document represents a | |||
| consensus of the IETF community. It has received public review | ||||
| and has been approved for publication by the IESG." | ||||
| IAB Stream: "This document is a product of the Internet Architecture | IAB Stream: "This document is a product of the Internet Architecture | |||
| Board (IAB), and represents information that the IAB has deemed | Board (IAB), and represents information that the IAB has deemed | |||
| valuable to provide for permanent record. This document has been | valuable to provide for permanent record. This document has been | |||
| approved for publication by the IAB and is therefore not a | approved for publication by the IAB and is therefore not a | |||
| candidate for any level of Internet Standard, see section | candidate for any level of Internet Standard; see section | |||
| Section 2 of RFCXXXX." | Section 2 of RFCXXXX." | |||
| IRTF Stream: "This document is a product of the Internet Research | IRTF Stream: "This document is a product of the Internet Research | |||
| Task Force (IRTF). The IRTF publishes the results of Internet- | Task Force (IRTF). The IRTF publishes the results of Internet- | |||
| related research and development activities. These results might | related research and development activities. These results might | |||
| not be suitable for deployment. This document has been approved | not be suitable for deployment. This document has been approved | |||
| for publication by the IRSG and is therefore not a candidate for | for publication by the IRSG. It is not a product of the IETF and | |||
| any level of Internet Standard, see section Section 2 of RFCXXXX." | is therefore not a candidate for any level of Internet Standard; | |||
| see section Section 2 of RFCXXXX." | ||||
| In addition a sentence indicating the consensus base within the | In addition a sentence indicating the consensus base within the | |||
| IRTF may be added: "This RFC represents the consensus of the | IRTF may be added: "This RFC represents the consensus of the | |||
| <insert_name> Research Group of the Internet Research Task Force | <insert_name> Research Group of the Internet Research Task Force | |||
| (IRTF)." or alternatively "This RFC represents the individual | (IRTF)." or alternatively "This RFC represents the individual | |||
| opinion(s) of one or more members of the <insert_name> Research | opinion(s) of one or more members of the <insert_name> Research | |||
| Group of the Internet Research Task Force (IRTF)". | Group of the Internet Research Task Force (IRTF)". | |||
| Independent Stream: "This document is a contribution to the RFC | Independent Stream: "This document is a contribution to the RFC | |||
| Series, independently of any other RFC stream. The RFC Editor has | Series, independently of any other RFC stream. The RFC Editor has | |||
| chosen to publish this document at its discretion and makes no | chosen to publish this document at its discretion and makes no | |||
| statement about its value for implementation or deployment. It is | statement about its value for implementation or deployment. It is | |||
| therefore not a candidate for any level of Internet Standard, see | therefore not a candidate for any level of Internet Standard; see | |||
| section Section 2 of RFCXXXX." | section Section 2 of RFCXXXX." | |||
| 3.3. Additional Notes | 3.3. Additional Notes | |||
| Exceptionally, a review and publication process may prescribe | Exceptionally, a review and publication process may prescribe | |||
| additional notes that will appear as labelled notes after the "Status | additional notes that will appear as labelled notes after the "Status | |||
| of This Memo". | of This Memo". | |||
| While this has been a common feature of recent RFCs, it is the goal | While this has been a common feature of recent RFCs, it is the goal | |||
| of this exercise to make the overall RFC structure adequately clear | of this exercise to make the overall RFC structure adequately clear | |||
| to remove the need for such notes, or at least make their usage truly | to remove the need for such notes, or at least make their usage truly | |||
| exceptional. | exceptional. | |||
| 3.4. Other structural information in RFCs | ||||
| RFCs contain other structural informational elements. The RFC Editor | ||||
| is responsible for the positioning and layout of these structural | ||||
| element. Note also that new elements may be introduced or obsoleted | ||||
| using a process consistent with [RFC4844]. These additions may or | ||||
| may not require documentation in an RFC. | ||||
| Currently the following structural information is available in RFCs. | ||||
| Copyright Notice A copyright notice with a reference to BCP78 and an | ||||
| Intellectual Property statement referring to BCP78 and BCP79. The | ||||
| content of these statements are defined by those BCPs. | ||||
| ISSN The International Standard Serial Number[ISO3297]: ISSN 2070- | ||||
| 1721. The ISSN uniquely identifies the RFC series as title | ||||
| regardless of language or country in which published. The ISSN | ||||
| itself has no significance other than the unique identification of | ||||
| a serial publication. | ||||
| Updates to the RFC A reference identifying where more information | ||||
| about the document can be found. This includes information wether | ||||
| the RFC has been updated, obsoleted, or clarified, a listing of | ||||
| possible errata, and information on how to submit errata as | ||||
| described in [I-D.rfc-editor-errata-process]. | ||||
| 4. Security considerations | 4. Security considerations | |||
| This document tries to clarify the descriptions of the status of an | This document tries to clarify the descriptions of the status of an | |||
| RFC. Misunderstanding the status of a memo could cause | RFC. Misunderstanding the status of a memo could cause | |||
| interoperability problems, hence security and stability problems. | interoperability problems, hence security and stability problems. | |||
| 5. IANA considerations | 5. IANA considerations | |||
| None. | None. | |||
| 6. RFC Editor Considerations | 6. RFC Editor Considerations | |||
| [To Be Removed before publication] | The RFC Editor is responsibile for maintaining the consistency of the | |||
| RFC series. To that end the RFC Editor maintains a style manual | ||||
| [insert reference]. In this memo we mention a few explicit | ||||
| structural elements that the RFC editor needs to maintain. The | ||||
| conventions for the content and use of all current and future | ||||
| elements are to be documented in the style manual. | ||||
| [The rest of this section contains specific instructions towards | ||||
| editing this document and can be removed before publication] | ||||
| The documents has two sections, including this one that need to be | The documents has two sections, including this one that need to be | |||
| removed after publication. | removed before publication as an RFC. This one and Appendix B. | |||
| ISSN: [TBD] is where the International Standards Serial Number will | This memo introduces a number of modifications that will have to be | |||
| need to be appear once assigned. | implemented in various tools, such as the xml2rfc tool, the nit | |||
| tracker and the rfc-erratum portal. | ||||
| The number "XXXX" is to be replaced with RFC number of this memo. | The number "XXXX" is to be replaced with RFC number of this memo. | |||
| The Reference RFCXXXX-1 is to be replaced with the details of the RFC | ||||
| published prior to this publication. | ||||
| 7. References | 7. References | |||
| 7.1. Normative References | 7.1. Normative References | |||
| [RFC2026] Bradner, S., "The Internet Standards Process -- Revision | [RFC2026] Bradner, S., "The Internet Standards Process -- Revision | |||
| 3", BCP 9, RFC 2026, October 1996. | 3", BCP 9, RFC 2026, October 1996. | |||
| [RFC2223] Postel, J. and J. Reynolds, "Instructions to RFC Authors", | [I-D.housley-iesg-rfc3932bis] | |||
| RFC 2223, October 1997. | Alvestrand, H. and R. Housley, "IESG Procedures for | |||
| Handling of Independent and IRTF Stream Submissions", | ||||
| [RFC4844] Daigle, L. and Internet Architecture Board, "The RFC | draft-housley-iesg-rfc3932bis-01 (work in progress), | |||
| Series and RFC Editor", RFC 4844, July 2007. | August 2008. | |||
| 7.2. Informative References | 7.2. Informative References | |||
| [ISO3297] Technical Committee ISO/TC 46, Information and | [ISO3297] Technical Committee ISO/TC 46, Information and | |||
| documentation, Subcommittee SC 9, Identification and | documentation, Subcommittee SC 9, Identification and | |||
| description., "Information and documentation - | description., "Information and documentation - | |||
| International standard serial number (ISSN)", 09 2007. | International standard serial number (ISSN)", 09 2007. | |||
| [RFCXXXX-1] | [RFC0003] Crocker, S., "Documentation conventions", RFC 3, | |||
| Blaaa Fooo, "[The RFC previous to this one]", --- 2007. | April 1969. | |||
| [RFC2223] Postel, J. and J. Reynolds, "Instructions to RFC Authors", | ||||
| RFC 2223, October 1997. | ||||
| [RFC2629] Rose, M., "Writing I-Ds and RFCs using XML", RFC 2629, | [RFC2629] Rose, M., "Writing I-Ds and RFCs using XML", RFC 2629, | |||
| June 1999. | June 1999. | |||
| [RFC3978] Bradner, S., "IETF Rights in Contributions", BCP 78, | [RFC3978] Bradner, S., "IETF Rights in Contributions", BCP 78, | |||
| RFC 3978, March 2005. | RFC 3978, March 2005. | |||
| [RFC4844] Daigle, L. and Internet Architecture Board, "The RFC | ||||
| Series and RFC Editor", RFC 4844, July 2007. | ||||
| [I-D.rfc-editor-errata-process] | ||||
| Ginoza, S., Hagens, A., and R. Braden, "RFC Editor | ||||
| Proposal for Handling RFC Errata", | ||||
| draft-rfc-editor-errata-process-02 (work in progress), | ||||
| May 2008. | ||||
| Appendix A. Acknowledgements | Appendix A. Acknowledgements | |||
| Thanks to Bob Braden, Brian Carpenter, Steve Crocker and John Klensin | Thanks to Bob Braden, Brian Carpenter, Steve Crocker and John Klensin | |||
| who provided background information and inspiration. | who provided background information and inspiration. | |||
| Various people have made suggestions that improved the document. | Various people have made suggestions that improved the document. | |||
| Among them are: Loa Andersson, Lars Eggert, Russ Housley, David Oran. | Among them are: Loa Andersson, Lars Eggert, Alfred Hines, Russ | |||
| Housley, and David Oran. | ||||
| This document was produced using the xml2rfc tool [RFC2629]. | This document was produced using the xml2rfc tool [RFC2629]. | |||
| Appendix B. Document Editing Details | Appendix B. Document Editing Details | |||
| [To Be Removed before publication] | [To Be Removed before publication] | |||
| This section will contain a discription of the changes between the | B.1. version 00->01 | |||
| various versions of this document. | ||||
| Fixed the header so it appropriatly shows that the document updates | ||||
| RFC 4844, 2223. And added a link to 3932-bis that should appear in | ||||
| tandem with this publication. | ||||
| Introduced the "Other structural information in RFCs" section and | ||||
| moved the ISSN number from the front matter to this section. The | ||||
| "Other structural information in RFCs" intends to give very rough | ||||
| guidance providing the RFC editor with sufficient freedom to move | ||||
| pieces around and edit them to please the eye and mind. | ||||
| Modified the last sentence 3rd paragraph of the Status of this memo | ||||
| section for the IRTF Stream in accordance to a suggestion by Aaron | ||||
| Falk; Indicating that review happend by the IRSG and not indicating | ||||
| that review did not happen by the IESG. | ||||
| Introduced the square brackets around the <author affiliation> in the | ||||
| header. To highlight this is an optional elelment. | ||||
| The definition of the "Clarifies" relation has been taken out. There | ||||
| are arguments that introducing the relation needs a bit more thought | ||||
| and is better done by a seperate document. | ||||
| Provided the RFC Editor with responsibility to maintain several text | ||||
| pieces. | ||||
| In Section 3.2 some modifications were applied to the text. | ||||
| The <discription> contains the full name of the stream. | ||||
| RFC2223 and 4844 moved to the informative reference section. | ||||
| Although I am not sure if those are not normative. Guidance!!! | ||||
| B.1.1. open issues | ||||
| Does the RFC Editor wants to supply text with respect to the level of | ||||
| review in Section 3.2 for the Independent Stream? | ||||
| Authors' Addresses | Authors' Addresses | |||
| Leslie Daigle (editor) | Leslie Daigle (editor) | |||
| Email: daigle@isoc.org, leslie@thinkingcat.com | Email: daigle@isoc.org, leslie@thinkingcat.com | |||
| Olaf M. Kolkman (editor) | Olaf M. Kolkman (editor) | |||
| Internet Architecture Board | ||||
| Email: olaf@nlnetlabs.nl | Email: olaf@nlnetlabs.nl | |||
| Internet Architecture Board | Internet Architecture Board | |||
| Email: iab@iab.org | Email: iab@iab.org | |||
| Full Copyright Statement | Full Copyright Statement | |||
| Copyright (C) The IETF Trust (2008). | Copyright (C) The IETF Trust (2008). | |||
| End of changes. 45 change blocks. | ||||
| 103 lines changed or deleted | 195 lines changed or added | |||
This html diff was produced by rfcdiff 1.48. The latest version is available from http://tools.ietf.org/tools/rfcdiff/ | ||||