Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 19 additions & 17 deletions draft-ietf-git-using-github.md
Original file line number Diff line number Diff line change
Expand Up @@ -713,11 +713,12 @@ audience. Documents submitted as Internet-Drafts are not expected to address
all open issues or merge outstanding pull requests.

Editors SHOULD create a new Internet-Draft submission two weeks prior to every
session (see Section 7.1 of {{?RFC2418}}). Though discussion could use the
current version of a document from version control, participants in a session
can't be expected to monitor changes to documents in real-time; a published
Internet-Draft ensures that there is a common, stable state that is known to all
participants.
session, which includes IETF meetings, other in-person meetings, and telephone
or video conferences (see Section 7.1 of {{?RFC2418}}). Though discussion could
use the current version of a document from version control, participants in a
session can't be expected to monitor changes to documents in real-time; a
published Internet-Draft ensures that there is a common, stable state that is
known to all participants.

Revisions used to generate documents that are submitted as Internet-Drafts
SHOULD be tagged in repositories to provide a record of submissions.
Expand All @@ -736,23 +737,24 @@ Monitoring activity on GitHub can require a greater time commitment than
following a mailing list. This is because there is an increased volume of
activity to follow. Participants who wish to limit this time commitment might
follow GitHub activity selectively, either by following only specific issues or
by occasionally reviewing the state of the document. Chairs are reminded that
assessing consensus based on GitHub content alone cannot be assumed to reach all
interested participants.
by occasionally reviewing the state of the document. Other participants might
not use GitHub at all. Chairs are reminded that assessing consensus based on
GitHub content alone cannot be assumed to reach all interested participants.

Chairs MUST consider input from all discussion venues when assessing consensus
including GitHub, mailing lists, and in-person meetings. Each venue has
different selection biases that might need to be considered.

A Working Group chair MUST consult the Working Group mailing list for any issue
that is potentially contentious. Relying on input provided through GitHub alone
might result in gaining input from a narrower set of participants. This
includes important milestones like Working Group Last-Call, where review from
the widest possible audience ensures a higher quality document. Managing input
from multiple sources in assessing consensus is similar to what is needed when
balancing mailing list discussion versus in-person meeting discussion.

It is expected that technical decisions will be made based on discussion and
interaction on GitHub. This is especially the case during early stages of
development of a document. Any decisions are ultimately confirmed through
review, and ultimately, through Working Group Last Call (see Section 7.4 of
{{!RFC2418}}).
the widest possible audience ensures a higher quality document.

If permitted, GitHub will be used for technical discussion and decisions,
especially during early stages of development of a document. Any decisions are
ultimately confirmed through review, and ultimately, through Working Group Last
Call (see Section 7.4 of {{!RFC2418}}).

The use of issues and labels has proven to be effective in managing contentious
issues. Explicitly labeling closed issues to explicitly identify those with
Expand Down