I noticed (and I may not have been the only one) about a month ago that we
Gen-ART reviewers are starting to assume that Gen-ART is fairly widely
understood (to the point of saying things like "everybody knows about
Gen-ART, right?"), but Gen-ART has never been presented to the IETF
community as a whole, and even newbies like Fred Baker (I am kidding) don't
know who we are, why we are annoying the editors, and what they should do
next after we provide a review.
We knocked out a very quick FAQ just prior to IETF 64, and had a few
comments on it, but we were all in last-minute mode; if you see anything
that looks unclear or questionable, please let us all know, so we can put
the FAQ someplace well-known, and reviewers can all refer to the same
information (and our posted reviews can be a bit shorter).
Thanks,
Spencer
p.s. JohnL used the most current FAQ text available, but it still had a
couple of needed changes reflecting Scott Brim's note to the list. I've made
the edits reflecting Scott's comments, and note that Brian still needs to
confirm whether new volunteer reviewers contact the General Area Director or
the Gen-ART secretary (and the
http://www.alvestrand.no/ietf/gen/art/reviewer-list.html URL needs to
reflect the right answer).
Q: What is Gen-ART?
A: The General Area Review Team. They provide gneralist 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.
Q: Who is Gen-ART?
A: The current membership list is maintained at
http://www.alvestrand.no/ietf/gen/art/reviewer-list.html. We do accept
new reviewers - volunteers should contact the Gen-ART secretary (see
below) < NOTE that this phrasing is Brian's, but the URL actually says
"contact the General Area director" - we just need to say the same thing
in both places>
Q: What does the Gen-ART secretary do and how do I find him/her?
A: 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.alvestrand.no/ietf/gen/art/gen-art.html.
Q: Why is my document being reviewed?
A: Two 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).
Q: How was my Gen-ART reviewer selected?
A: 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.
Q: Are the reviews public or private?
A: 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 publically viewable, at
http://www.ietf.org/mail-archive/web/gen-art/current/index.html.
Q: Are Gen-ART comments binding?
A: Not unless the General Area director agrees with the 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, the General Area
director may ask the Gen-ART reviewer, "does the new version of the
draft address your concerns?"
Q: I have comments from a Gen-ART reviewer - do I revise the document
immediately?
A: Ask your AD/document shepherd. Practice varies between areas. A fair
number of comments area resolved with Notes to the RFC Editor. But the
General Area director will not ask for a respin before a telechat.
Q: What if the Gen-ART reviewer is just flat wrong?
A: 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".
Q: Is there any written Gen-ART procedure?
A: Currently
http://www.ietf.org/internet-drafts/draft-doria-genart-experience-01.txt
,
and - guess what - we're still reviewing it :-)
_______________________________________________
Gen-art mailing list
[email protected]
https://www1.ietf.org/mailman/listinfo/gen-art
_______________________________________________
Gen-art mailing list
[email protected]
https://www1.ietf.org/mailman/listinfo/gen-art