Subject: [edu-team] Tutorial on Document Lifecycle for IETF 70

From: Alice Hagens <[email-masked]>
Date: Tue, 23 Oct 2007 18:19:11 -0700

Edu team,

Here's suggested text for http://www3.ietf.org/meetings/70- 
Tutorial_DocLife.txt. Please let me know if you have suggestions/ 
corrections.

Tutorial on the IETF Document Lifecycle
Presented by: Margaret Wasserman & Alice Hagens

Sunday, December 2, 2007 - 15:00-16:45
======================================
This tutorial offers an overview of producing documents in the IETF,  
from version 00 of an Internet-Draft to publication as an RFC.  We  
will cover the working group process, and the required and suggested  
contents of an Internet-Draft, including information from IANA staff  
about writing IANA Considerations sections.   We will walk through  
the lifecycle including authorship, WG draft, IETF Last Call, IESG  
evaluation, and what to expect during the RFC publication process.   
We will provide a set of helpful hints to authors about formatting  
rules and editorial policies that often improve the quality of the  
resulting documents.  We will summarize the states of the RFC  
publication process and provide an opportunity to ask questions of  
RFC Editor staff.

Thanks,
Alice
for the RFC Editor

> From: Alice Hagens <[email-masked]>
> Date: October 16, 2007 11:41:08 AM PDT
> To: Margaret Wasserman <[email-masked]>
> Cc: RFC Editor <[email-masked]>
> Subject: Re: [edu-team] Document Lifecycle class proposal for IETF 70
>
> Hi Margaret,
>
> Just wanted to check in with you about the Document Lifecycle  
> tutorial for IETF 70. At the end of this message are the notes from  
> after talking Spencer, and notes on the subsequent comments from  
> the edu team.
>
>> Alice & Spencer, could you send Marcia a short description of the  
>> Document Lifecycle class for the agenda?
>
> Here's a rough draft of the description for Marcia (http:// 
> www3.ietf.org/meetings/70-Tutorial_DocLife.txt)
> Feel free to edit as you like.
>
>
> Tutorial on the IETF Document Lifecycle
>
> Presented by: Margaret Wasserman & Alice Hagens
>
> Sunday, December 2, 2007 - 15:00-16:45
> ======================================
> This tutorial offers an overview of producing documents in the  
> IETF, from version 00 of an Internet-Draft to publication as an  
> RFC.  We will cover the working group process, and the required and  
> suggested contents of an Internet-Draft, including information from  
> IANA staff about writing IANA Considerations sections.   We will  
> walk through the lifecycle including authorship, WG draft, IETF  
> Last Call, IESG evaluation, and what to expect during the RFC  
> publication process.  We will provide a set of helpful hints to  
> authors about formatting rules and editorial policies that often  
> improve the quality of the resulting documents.  We will summarize  
> the states of the RFC publication process and provide an  
> opportunity to ask questions of RFC Editor staff.
>
>
> Let me know if you still want to shoot for the Nov. 2 goal for  
> having a draft of the slides!
>
> Thanks,
> Alice
>
> On Jun 25, 2007, at 9:48 AM, Spencer Dawkins wrote:
>> As discussed on previous calls - Alice and I talked last week, and
>> this is more or less where we ended up. We aren't thinking of large
>> amounts of new material, so it's mostly combining slide sets and then
>> deleting the parts we don't want to include immediately.
>>
>> Our IETF 70 plan is to do a document lifecycle class, based on slides
>> from WG leadership and from RFC Editor training tutorials. We might
>> remove these slides from the other tutorials someday, but not before
>> IETF 70, and we don't expect Document Lifecycle to be offered at the
>> same IETF as the other tutorials.
>>
>> SHORT overview of "where RFCs come from" - there are actually *4*  
>> streams
>>
>> SHORT WG process overview, mostly pictures and pointers.
>>
>> The document lifecycle roadmap, mostly pictures and pointers
>>
>> Content of a 00 Internet Draft - required and suggested
>>
>> One slide on XML2RFC and pointer to tutorial
>>
>> Steps during individual-author draft stage (all the following  
>> sections
>> are explained from
>> the author's perspective)
>>
>> Steps during WG draft stage
>>
>> Steps during IETF Last Call/IESG evaluation stage
>>
>> Steps during post-approval stage
>>
>> Please let us know if you think we were supposed to produce a
>> different concept - if we're good on the concept, please let us know
>> and we'll start slicing slides.
>>
>> Spencer
>
>
> On Jul 25, 2007, at 8:45 AM, Alice Hagens wrote:
>> Hi, Spencer,
>> Here are a few notes on the doc. lifecycle class from the edu team  
>> meeting today. Hopefully the team will chime with corrections/ 
>> comments. Also, I think Margaret will send the minutes.
>>
>> 1) Make sure to clarify:
>>
>> - the difference between types of documents in the IETF stream:
>>   WG / individual (can't be STD) / AD-sponsored (can be STD)
>>
>> - the definition & politics of deciding the category of a document
>>   for example, informational vs. experimental
>>
>> - the difference between
>>   Individual (IETF)
>>   Independent (RFC Editor: www.rfc-editor.org/indsubs.html)
>>
>> - can a company's highly patented tech be published as informational?
>>   (led to "covering IPR" below)
>>
>> 2) Point to 4 docs below and provide some *why*
>> for choosing among/within streams. for example,
>> why choose AD-sponsored vs. Independent
>>
>> - 4845 on the IAB stream
>> - 4846 on the Independent stream
>> - http://www.ietf.org/IESG/content/ions/ion-ad-sponsoring.html
>>   on AD-sponsored documents
>> - 4844 on the RFC Series and RFC Editor
>>   (this one is not as relevant to this tutorial, IMHO)
>>
>> 3) covering IPR
>> point to newcomer slides and RFC 3669
>>
>> 4) covering XML2RFC
>>
>> - point to the docs on xml.resource.org instead of the xml2rfc  
>> tutorial
>> because the tutorial needs to be updated to be useful
>>
>> - can Henrik's tools tutorial be combined with xml2rfc?
>> for example, 15 min. on xml2rfc in the tools tutorial.
>> another option: a tutorial that covers microsoft word, xml2rfc, nroff
>> meta-issue: Is the edu team actively encouraging xml2rfc?
>>
>> 5) Where do the WG leadership & RFC tutorials go now?
>> As Spencer wrote: not at the same IETF.
>> [option: email the WG chairs a link to the WG leadership slides]
>>
>> 6) deadline for a draft of the slides: Nov. 2
>
>
> On Jun 25, 2007, at 9:48 AM, Spencer Dawkins wrote:
>
>> As discussed on previous calls - Alice and I talked last week, and
>> this is more or less where we ended up. We aren't thinking of large
>> amounts of new material, so it's mostly combining slide sets and then
>> deleting the parts we don't want to include immediately.
>>
>> Our IETF 70 plan is to do a document lifecycle class, based on slides
>> from WG leadership and from RFC Editor training tutorials. We might
>> remove these slides from the other tutorials someday, but not before
>> IETF 70, and we don't expect Document Lifecycle to be offered at the
>> same IETF as the other tutorials.
>>
>> SHORT overview of "where RFCs come from" - there are actually *4*  
>> streams
>>
>> SHORT WG process overview, mostly pictures and pointers.
>>
>> The document lifecycle roadmap, mostly pictures and pointers
>>
>> Content of a 00 Internet Draft - required and suggested
>>
>> One slide on XML2RFC and pointer to tutorial
>>
>> Steps during individual-author draft stage (all the following  
>> sections
>> are explained from
>> the author's perspective)
>>
>> Steps during WG draft stage
>>
>> Steps during IETF Last Call/IESG evaluation stage
>>
>> Steps during post-approval stage
>>
>> Please let us know if you think we were supposed to produce a
>> different concept - if we're good on the concept, please let us know
>> and we'll start slicing slides.
>>
>> Spencer
>>
>>
>> _______________________________________________
>> edu-team mailing list
>> [email-masked]
>> https://www1.ietf.org/mailman/listinfo/edu-team
>

_______________________________________________
edu-team mailing list
[email-masked]
https://www1.ietf.org/mailman/listinfo/edu-team