Changes between Version 1 and Version 2 of GenARTFAQ


Ignore:
Timestamp:
May 20, 2010, 2:00:25 PM (10 years ago)
Author:
mary.ietf.barnes@…
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • GenARTFAQ

    v1 v2  
    11== GEN-ART Frequently Asked Questions (FAQ) ==
    2 ''Q: What is Gen-ART?''
     2'''Q: What is Gen-ART?'''
    33
    44A: The General Area Review Team. They provide generalist reviews for the General Area director (currently the IETF Chair), providing an additional set of eyes for documents as they are being considered for publication.
    55
    6 ''Q: Who is Gen-ART?''
     6'''Q: Who is Gen-ART?'''
    77
    8 A: The current membership list is maintained at http://www.alvestrand.no/ietf/gen/art/reviewer-list.html.
     8A: The current membership list is maintained at http://trac.tools.ietf.org/area/gen/trac/wiki/Reviewers/
    99
    10 Q: How can I join the Gen-ART review team?
     10'''Q: How can I join the Gen-ART review team?'''
    1111
    1212A: Interested volunteers should contact the General Area director, listed on the membership page.
    1313
    14 Q: What does the Gen-ART secretary do and how do I find him/her?
     14'''Q: What does the Gen-ART secretary do and how do I find him/her?'''
    1515
    1616A: The Gen-ART secretary is also listed on the membership page. The Gen-ART secretary tracks documents submitted for publication and assigns them to reviewers, and collects the reviews, posting them to http://www.softarmor.com/rai/temp-genart/
    1717
    18 Q: Why is my document being reviewed?
     18'''Q: Why is my document being reviewed?'''
    1919
    2020A: Three possible answers - most Gen-ART reviews are now assigned at  IETF Last Call time (answer #1). If a document is revised after IETF Last Call, or is processed so quickly that no Gen-ART reviewer has been assigned, it's reviewed after being placed on the IESG Telechat agenda (answer #2). Some ADs also request an Early Review before IETF Last Call - typically once the document is considered fairly mature within the WG (answer #3).
    2121
    22 Q: How was my Gen-ART reviewer selected?
     22'''Q: How was my Gen-ART reviewer selected?'''
    2323
    2424A: There is a mechanism, but it's more about leveling the review workload than selecting reviewers based on topic areas. Gen-ART reviewers are supposed to provide generalist reviews to Gen-ART (when reviewers are experts in a particular field, they should provide expert review to the working group, prior to IETF Last Call), so reviewers may recuse themselves ("I've read this spec too many times to act as Gen-ART reviewer"). The same Gen-ART reviewer will be assigned for IETF Last Call reviews and telechat reviews of a single specification, if the reviewer is available to provide both reviews.
    2525
    26 Q: Are the reviews public or private?
     26'''Q: Are the reviews public or private?'''
    2727
    2828A: The reviews are sent to the Gen-ART mailing list (which includes the General Area director). Ordinarily, copies are sent to shepherding ADs, document shepherds, working group chairs, and authors/editors, but the archives are publicly viewable, at http://www.ietf.org/mail-archive/web/gen-art/current/index.html.
    2929
    30 Q: Are Gen-ART comments binding?
     30'''Q: Are Gen-ART comments binding?'''
    3131
    3232A: Only if IESG review process makes them so - i.e., if the General Area director agrees with the comments and incorporates them in the IESG ballot as "DISCUSS" comments. Gen-ART does not have a formal role in the standards approval process - we're simply providing input for the General Area director who is deciding how to ballot the document. If the General Area director agrees with a serious concern expressed in a Gen-ART review, and uses it as the basis for a "DISCUSS", the General Area director may later ask the Gen-ART reviewer, "does the new version of the draft address your concerns?" See the next question for when to produce a new version.
    3333
    34 Q: I have comments from a Gen-ART reviewer - do I revise the document immediately?
     34'''Q: I have comments from a Gen-ART reviewer - do I revise the document immediately?'''
    3535
    3636A: Not unless your AD/document shepherd asks you to revise the document. Some comments may be resolved with Notes to the RFC Editor, and the IESG may choose to approve the document without requiring changes to address all Gen-ART comments, since Gen-ART reviews are not a formal part of the approval review cycle. The AD/document shepherd may also prefer to complete the entire approval review cycle before requesting an updated version of the document, in order to avoid confusion about exactly what version is being last-called, reviewed and approved. In no case should you submit an updated version of the document without consulting the AD/document shepherd.
    3737
    38 Q: What if the Gen-ART reviewer is just flat wrong?
     38'''Q: What if the Gen-ART reviewer is just flat wrong?'''
    3939
    4040A: The General Area director understands that these are reviews by generalists who are not experts in every protocol the IETF works on, plus security and MIBs. If you disagree with comments, say so. The gen-art reviewers *want* to hear feedback. They want to learn more about your area, and appreciate feedback about how helpful their comments are. And always remember that the IESG ballot position is called "DISCUSS", not "IMPERIAL EDICT" or "BLACKMAIL".
    4141
    42 Q: Is there any written Gen-ART procedure?
     42'''Q: Is there any written Gen-ART procedure?'''
    4343
    44 A: Currently http://www.alvestrand.no/ietf/gen/art/draft-doria-genart-experience-01.txt
     44A: Currently http://tools.ietf.org/id/draft-doria-genart-experience-01.txt