Internet Engineering Task Force (IETF)                        P. Hoffman
Request for Comments: 6433                                VPN Consortium
Updates: 6292                                              November 2011
Category: Informational
ISSN: 2070-1721
        
Internet Engineering Task Force (IETF)                        P. Hoffman
Request for Comments: 6433                                VPN Consortium
Updates: 6292                                              November 2011
Category: Informational
ISSN: 2070-1721
        

Requirements for a Working Group Milestones Tool

工作组里程碑工具的要求

Abstract

摘要

The IETF intends to provide a new tool to Working Group chairs and Area Directors for the creation and updating of milestones for Working Group charters. This document describes the requirements for the proposed new tool, and it is intended as input to a later activity for the design and development of such a tool. This document updates RFC 6292.

IETF打算为工作组主席和区域主管提供一个新工具,用于创建和更新工作组章程的里程碑。本文件描述了拟议新工具的要求,旨在作为设计和开发此类工具的后续活动的输入。本文档更新了RFC 6292。

Status of This Memo

关于下段备忘

This document is not an Internet Standards Track specification; it is published for informational purposes.

本文件不是互联网标准跟踪规范;它是为了提供信息而发布的。

This document is a product of the Internet Engineering Task Force (IETF). It represents the consensus of the IETF community. It has received public review and has been approved for publication by the Internet Engineering Steering Group (IESG). Not all documents approved by the IESG are a candidate for any level of Internet Standard; see Section 2 of RFC 5741.

本文件是互联网工程任务组(IETF)的产品。它代表了IETF社区的共识。它已经接受了公众审查,并已被互联网工程指导小组(IESG)批准出版。并非IESG批准的所有文件都适用于任何级别的互联网标准;见RFC 5741第2节。

Information about the current status of this document, any errata, and how to provide feedback on it may be obtained at http://www.rfc-editor.org/info/rfc6433.

有关本文件当前状态、任何勘误表以及如何提供反馈的信息,请访问http://www.rfc-editor.org/info/rfc6433.

Copyright Notice

版权公告

Copyright (c) 2011 IETF Trust and the persons identified as the document authors. All rights reserved.

版权所有(c)2011 IETF信托基金和确定为文件作者的人员。版权所有。

This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License.

本文件受BCP 78和IETF信托有关IETF文件的法律规定的约束(http://trustee.ietf.org/license-info)自本文件出版之日起生效。请仔细阅读这些文件,因为它们描述了您对本文件的权利和限制。从本文件中提取的代码组件必须包括信托法律条款第4.e节中所述的简化BSD许可证文本,并提供简化BSD许可证中所述的无担保。

1. Introduction
1. 介绍

[RFC2418] describes the guidelines and procedures for operation of IETF Working Groups (WGs). Every WG has milestones that the WG is supposed to meet, such as the publication of a particular Internet-Draft or the beginning of discussion on a particular topic. A WG's charter has several parts; one of those parts is the milestones. Changing milestones currently requires Area Director (AD) approval, but changing the charter text requires IESG approval.

[RFC2418]描述了IETF工作组(WG)的操作指南和程序。每个工作组都有工作组应该达到的里程碑,例如发布特定的互联网草案或开始讨论特定主题。工作组章程有几个部分;其中一个部分是里程碑。更改里程碑目前需要区域总监(AD)批准,但更改章程文本需要IESG批准。

Today, the tasks associated with creating and updating WG milestones are performed manually by the Secretariat. Normally, WG chairs send email to their AD requesting that milestones be created or updated. They send mail to the their AD, or directly to the Secretariat, when one or more milestone has been met. Apart from during WG creation, these updates will be made through a separate tool after the requirements in this document and in [RFC6292] are met.

今天,与创建和更新工作组里程碑相关的任务由秘书处手动执行。通常,工作组主席会向他们的广告发送电子邮件,要求创建或更新里程碑。当达到一个或多个里程碑时,他们将邮件发送给他们的广告,或直接发送给秘书处。除了在工作组创建期间,这些更新将在满足本文件和[RFC6292]中的要求后通过单独的工具进行。

In early 2011, the IETF approved a set of requirements for a tool that helps ADs with the WG chartering and rechartering process [RFC6292]. During the IESG discussion of that document, it became clear that everyone wanted more automation to the milestones process. This document is intended to bring that discussion to a general consensus for the requirements for the eventual tool.

2011年初,IETF批准了一套工具要求,该工具帮助ADs完成工作组租船和再租船流程[RFC6292]。在IESG对该文件的讨论中,很明显,每个人都希望里程碑过程更加自动化。本文件旨在使讨论就最终工具的要求达成普遍共识。

Note that this document only discusses updating milestones that an active WG is working against. As described in [RFC6292], when a WG is rechartering, the new charter might also include new milestones. The tool described here must not change the milestones that are proposed for a WG recharter. That is, there must be two sets of milestones kept by the Datatracker, one for the current WG charter and one for a proposed recharter; the tool described here must only affect the first of these two sets.

请注意,本文档仅讨论更新活动工作组所针对的里程碑。如[RFC6292]中所述,当工作组重新制定章程时,新章程可能还包括新的里程碑。此处描述的工具不得改变工作组再培训计划的里程碑。也就是说,Datatracker必须保留两组里程碑,一组用于当前工作组章程,另一组用于拟议的再培训者;此处描述的工具必须仅影响这两组中的第一组。

The IETF Administrative Oversight Committee (IAOC) would like to create a better tool for the tasks of WG milestone creation and updating, and this document lists the requirements for such a tool. When complete, this document may be used to issue an request for proposals for the design and development of the tool. This document was prepared at the request of the IAOC.

IETF管理监督委员会(IAOC)希望为工作组里程碑创建和更新任务创建一个更好的工具,本文件列出了此类工具的要求。完成后,本文件可用于发布工具设计和开发的建议书请求。本文件是应IAOC的要求编写的。

2. Users of the Tool
2. 工具的用户

This tool can only be used by WG chairs and ADs, not by other members of the IETF community. The tool will use the login and access control features that will already be in place from the outcome of

此工具只能由工作组主席和广告使用,IETF社区的其他成员不能使用。该工具将使用登录和访问控制功能,这些功能将在

the tool created by [RFC6292]. It is important to note that some people are chairs for more than one WG, and everyone must be able to use the tool for all of the WGs that they chair.

由[RFC6292]创建的工具。需要注意的是,有些人担任多个工作组的主席,每个人都必须能够为他们主持的所有工作组使用该工具。

Any AD can add or update any milestone for any WG. Normally, an AD would only add or update milestones in the WGs for which they are the responsible AD, but ADs are not bound by such a limitation. (This is the same model used in the Datatracker for other actions: it allows one AD to carry the load for an AD who is temporarily unable to perform such tasks.) WG chairs can only add or update milestones for WGs of which they are chairs.

任何广告都可以为任何工作组添加或更新任何里程碑。通常情况下,广告只会在工作组中添加或更新他们是负责广告的里程碑,但广告不受此类限制的约束。(这与Datatracker中用于其他操作的模型相同:它允许一个广告为暂时无法执行此类任务的广告承担负载。)工作组主席只能为其担任主席的工作组添加或更新里程碑。

The IETF Secretariat needs to be able to perform the same tasks as the ADs in order to fix problems or to make emergency changes.

IETF秘书处需要能够执行与ADs相同的任务,以便修复问题或进行紧急更改。

The database will record the date and person who initiates any addition of, or change to, a milestone. The contents of the database will be visible to the IETF community so that anyone can see who made a particular change to a milestone.

数据库将记录开始添加或更改里程碑的日期和人员。数据库的内容将对IETF社区可见,以便任何人都可以看到谁对里程碑进行了特定更改。

3. Updating, Adding, and Deleting Milestones
3. 更新、添加和删除里程碑

A WG chair needs to see all of the milestones for that chair's WG in the tool. The chair needs to be able to change any milestone record for that chair's WG. In each existing record, the chair needs to be able to change the due date, the finished date, the associated Internet-Drafts, and the description of the milestone. The chair also needs to be able to delete existing milestones.

工作组主席需要在工具中查看该主席工作组的所有里程碑。主席需要能够更改主席工作组的任何里程碑记录。在每个现有记录中,主席需要能够更改截止日期、完成日期、相关互联网草稿以及里程碑的描述。主席还需要能够删除现有的里程碑。

A WG chair needs to be able to add one or more milestone records to the database for their WG. The chair needs to be able to specify the due date, zero or more associated Internet-Drafts, and the description of the record that he or she is adding.

工作组主席需要能够为其工作组向数据库添加一个或多个里程碑记录。主席需要能够指定截止日期、零份或多份相关互联网草稿,以及他或她正在添加的记录的描述。

4. Acceptance of Milestone Additions and Changes
4. 接受里程碑添加和更改

There are six actions associated with adding and changing milestones:

有六项操作与添加和更改里程碑相关:

o create new milestones

o 创建新的里程碑

o delete milestones

o 删除里程碑

o change milestone descriptions

o 更改里程碑描述

o change milestone due dates

o 更改里程碑到期日

o change which Internet-Drafts are associated with a milestone

o 更改与里程碑关联的Internet草稿

o assert that a milestone is no longer due

o 断言里程碑不再到期

In addition to the above six actions, the tool must support reordering of the list of milestones.

除了上述六个操作之外,该工具还必须支持里程碑列表的重新排序。

WG chairs can change milestone due dates, change which Internet-Drafts are associated with a milestone, can assert that a milestone is no longer due, for their WG, and reorder the list. When any of these three actions are taken in the Datatracker, an email notification is sent to the AD for the WG as well as to the WG's chairs; the changes are reflected immediately in the Datatracker without any need for approval from an AD.

工作组主席可以更改里程碑到期日期,更改与里程碑相关联的互联网草稿,可以为其工作组声明里程碑不再到期,并重新排列列表。在Datatracker中采取这三项行动时,会向工作组的广告以及工作组的主席发送电子邮件通知;这些更改会立即反映在Datatracker中,无需获得广告批准。

WG chairs can also create new milestones, delete milestones, and change milestone descriptions; however, any of these action are not reflected in the Datatracker until the action is approved by an AD. When a WG chair makes the proposed change, an email notification is sent to the AD for the WG as well as to the WG's chairs.

工作组主席还可以创建新的里程碑、删除里程碑和更改里程碑描述;然而,在广告批准之前,这些行动中的任何一项都不会反映在Datatracker中。当工作组主席做出提议的变更时,会向工作组的广告以及工作组的主席发送电子邮件通知。

When creating a milestone, it must be possible to set a due date. It must also be to change the due date at any time.

创建里程碑时,必须能够设置截止日期。还必须随时更改到期日。

When asserting that a milestone is no longer due, it must be possible to provide an arbitrary short description phrase. Often this phrase will be "Done", but other phrases such as "On hold" are also allowed. When the Datatracker presents a milestone, the only information that is expected to be associated with the provided phrase is that the milestone is no longer due. The Datatracker will present the list of milestones in the order given in the tool.

当断言里程碑不再到期时,必须能够提供任意简短的描述短语。这个短语通常是“完成”的,但也允许使用其他短语,如“暂停”。当Datatracker呈现里程碑时,预期与所提供短语相关联的唯一信息是里程碑不再到期。Datatracker将按照工具中给出的顺序显示里程碑列表。

As noted in Section 2, any AD can take any of these six actions, as well as reordering the list. After this tool is launched, the IETF Secretariat will no longer need to post a change to the database because the tool will do this without intervention by the Secretariat; however, the Secretariat can take any of these six actions as well.

如第2节所述,任何广告都可以采取这六种行动中的任何一种,以及对列表进行重新排序。在该工具启动后,IETF秘书处将不再需要发布对数据库的更改,因为该工具将在没有秘书处干预的情况下完成此操作;然而,秘书处也可以采取这六项行动中的任何一项。

When adding or editing a milestone, the AD or WG Chair must be able to review and change the proposed change before committing the change to the Datatracker. This will help prevent errors and reduce the number of fixes that need to be made.

在添加或编辑里程碑时,AD或WG主席必须能够在将变更提交给Datatracker之前审查和更改提议的变更。这将有助于防止错误并减少需要进行的修复的数量。

Once a day, the Datatracker will look for changes to the milestones for a WG. If changes to milestones have been made in the past 24 hours, the Datatracker will send one message to the WG listing all the changes from that period.

每天一次,Datatracker将查找工作组里程碑的更改。如果在过去24小时内对里程碑进行了更改,Datatracker将向工作组发送一条消息,列出该期间的所有更改。

The Datatracker needs to have a method for ADs and the Secretariat to see all the milestones that are pending approval. This list should be sorted by the responsible AD.

数据跟踪器需要有一种方法,让ADs和秘书处能够看到所有待批准的里程碑。此列表应按负责的广告进行排序。

5. Mapping Milestones to Internet-Drafts
5. 将里程碑映射到Internet草稿

There is currently no mechanism to map WG milestones to Internet-Drafts. While most milestones map one-to-one with Internet-Drafts, some milestones do not map to any Internet-Draft (such as those that say when a general discussion will begin or finish), and other milestones map to multiple Internet-Drafts (such as a milestone that covers a topic that has multiple related Internet-Drafts). Some Internet-Drafts are part of more than one milestone.

目前还没有将工作组里程碑映射到互联网草案的机制。虽然大多数里程碑与互联网草案一一对应,但有些里程碑并不对应于任何互联网草案(例如,说明一般性讨论何时开始或何时结束的里程碑),而其他里程碑则对应于多个互联网草案(例如,涵盖具有多个相关互联网草案的主题的里程碑)。一些互联网草案是不止一个里程碑的一部分。

The new tool is required to make mappings between milestones and Internet-Drafts explicit, and those drafts must be listed in views of the milestone. This change will require a change to the Datatracker database to make such an association.

新工具需要明确里程碑和互联网草案之间的映射,这些草案必须在里程碑视图中列出。此更改将需要更改Datatracker数据库以进行此类关联。

When an Internet-Draft that is mapped to a milestone changes its state to "Submitted to IESG for Publication" as described in [RFC6174], the tool will send a message to the WG chairs to remind them that they might want to update the milestone. Note that this message will not apply to all Internet-Drafts that are mapped to a milestone, so it is up to the WG chairs to decide what to do when such a message is received.

当映射到里程碑的互联网草案将其状态更改为[RFC6174]中所述的“提交给IESG发布”时,该工具将向工作组主席发送一条消息,提醒他们可能需要更新里程碑。请注意,此消息不适用于所有映射到里程碑的互联网草案,因此,当收到此类消息时,应由工作组主席决定如何处理。

6. Reminders for WG Chairs and ADs
6. 工作组椅子和广告的提醒

Milestone changes that do not require AD approval are made immediately. Requested changes that require AD approval are tracked by the tool. If the AD has not approved or rejected the change within a week, email listing the request and the request date is sent to the WG chairs and AD. That email is sent every week until the AD has approved or rejected the request; the WG chairs are CC'd on this mail.

不需要AD批准的里程碑更改将立即进行。需要AD批准的请求更改由该工具跟踪。如果广告在一周内未批准或拒绝变更,则向工作组主席和广告发送列出请求和请求日期的电子邮件。在广告批准或拒绝请求之前,每周发送该电子邮件;工作组主席在这封邮件上抄送。

The tool will also send WG chairs reminders about pending milestones. A message is sent when a milestone is one month from being due, at the time a milestone is due, and every month in which a milestone is overdue.

该工具还将发送有关待定里程碑的提醒。当里程碑到期后一个月、里程碑到期时以及里程碑过期的每个月发送消息。

The tool will also send WG chairs reminders about Internet-Drafts that are mapped to milestones. A message is sent when such a draft is one month from expiring, and at the time that a draft expires. If a milestone is mapped to a draft that is expired, mail reminding the chairs of this will be sent weekly.

该工具还将向工作组主席发送有关映射到里程碑的互联网草案的提醒。当汇票到期一个月后,在汇票到期时发送消息。如果里程碑映射到过期的草案,则每周将向主席发送提醒此事的邮件。

When a WG chair makes an Internet-Draft a WG work item, the Datatracker will remind them that they may want to also add that document to a milestone.

当工作组主席将互联网草案作为工作组工作项目时,Datatracker将提醒他们可能还希望将该文档添加到里程碑中。

7. Viewing Changes in Milestones
7. 查看里程碑中的更改

[RFC6292] describes an extension to the Datatracker to allow the IETF community to view, search, and track changes to WG charters. This document updates those requirements to allow the IETF community to view, search, and track changes to WG milestones.

[RFC6292]描述了Datatracker的扩展,允许IETF社区查看、搜索和跟踪工作组章程的更改。本文件更新了这些要求,以允许IETF社区查看、搜索和跟踪工作组里程碑的变更。

Section 5.1 of [RFC6292] is updated to allow searching for any text in a milestone's description, as well as for the name of any Internet-Draft name that is mapped to any milestone.

[RFC6292]第5.1节已更新,以允许搜索里程碑描述中的任何文本,以及映射到任何里程碑的任何互联网草案名称的名称。

A new capability will be added to the Datatracker that is similar to that described in Section 5.2 of [RFC6292], but instead of showing differences between charters, it shows differences between the full set of milestones. Any time a milestone is added, deleted, or any of its fields changed, or the list is reordered, the full set of milestones is considered changed. A user should be able to easily compare two full sets of milestones with the differences highlighted. The tool should show who made each change when changes are viewed. These features should be found in the same place as the features described in Section 5.2 of [RFC6292].

Datatracker将添加一个新功能,与[RFC6292]第5.2节中所述的功能类似,但它没有显示特许权之间的差异,而是显示了全套里程碑之间的差异。无论何时添加、删除里程碑,或更改其任何字段,或对列表重新排序,都会将整个里程碑集视为已更改。用户应该能够轻松地比较两套完整的里程碑,并突出显示差异。查看更改时,该工具应显示每个更改的执行者。这些特征应与[RFC6292]第5.2节中描述的特征位于同一位置。

The tool needs to provide an Atom feed [RFC4287] for the changes in the milestones for a WG. The contents of the feed are the full WG record, plus an indication of what changed since the last entry in the feed and who made the change. This feed is different than the feed described in Section 5.3 of [RFC6292], but it should be offered to users in the same places as that feed is offered.

该工具需要为工作组里程碑中的更改提供Atom提要[RFC4287]。feed的内容是完整的WG记录,加上自feed中最后一个条目以来发生了什么变化以及谁进行了更改的指示。此提要不同于[RFC6292]第5.3节中所述的提要,但它应提供给位于与该提要相同位置的用户。

When a milestone is marked as no longer due, the Datatracker will display the month and year that this change was made and will display the status (such as "Done" or "On hold").

当里程碑标记为不再到期时,Datatracker将显示进行此更改的月份和年份,并显示状态(如“完成”或“暂停”)。

8. Security Considerations
8. 安全考虑

Creating a new tool for updating the milestones of WGs does not affect the security of the Internet in any significant fashion.

创建用于更新工作组里程碑的新工具不会以任何重大方式影响互联网的安全。

9. Acknowledgements
9. 致谢

This document draws heavily on ideas from various WG chairs and ADs on the wgchairs@ietf.org mailing list.

本文件大量借鉴了各种工作组主席的想法和网站上的广告wgchairs@ietf.org邮件列表。

10. References
10. 工具书类
10.1. Normative References
10.1. 规范性引用文件

[RFC2418] Bradner, S., "IETF Working Group Guidelines and Procedures", BCP 25, RFC 2418, September 1998.

[RFC2418]Bradner,S.,“IETF工作组指南和程序”,BCP 25,RFC 2418,1998年9月。

[RFC6174] Juskevicius, E., "Definition of IETF Working Group Document States", RFC 6174, March 2011.

[RFC6174]Juskevicius,E.“IETF工作组文件状态的定义”,RFC 61742011年3月。

[RFC6292] Hoffman, P., "Requirements for a Working Group Charter Tool", RFC 6292, June 2011.

[RFC6292]Hoffman,P.“工作组章程工具的要求”,RFC 62922011年6月。

10.2. Informative References
10.2. 资料性引用

[RFC4287] Nottingham, M., Ed. and R. Sayre, Ed., "The Atom Syndication Format", RFC 4287, December 2005.

[RFC4287]诺丁汉,M.,Ed.和R.Sayre,Ed.,“原子联合格式”,RFC 4287,2005年12月。

Author's Address

作者地址

Paul Hoffman VPN Consortium

保罗·霍夫曼VPN联盟

   EMail: paul.hoffman@vpnc.org
        
   EMail: paul.hoffman@vpnc.org