Subject: [Ietf-and-github] Abstract clarification: is this draft not also advising Was who already use GitHub?

From: Stephan Wenger <[email-masked]>
Date: Mon, 4 Mar 2019 15:30:53 +0000

Hi,

Here's the current abstract:
"
   The use of GitHub in IETF working group processes is increasing.
   This document describes possible uses and conventions for working
   groups which are considering starting to use GitHub.  It does not
   mandate any processes, and does not intend to change the processes
   used by current working groups.
"

The first sentence relates only to WGs "which are considering starting to use GitHub "; in other words, newcomer WGs to GitHub.  Yet, later in the draft there is a wealth of information, a lot of which seems to affect also existing WGs that use GitHub, but may not have yet implemented the suggestions in the draft.  As one random example, section 2.3 suggests an API related to personnel changes.  Surely such an API would be useful also for the current GitHub-using WGs?

Here's a possible fix: add "using, or" before "considering".  Perhaps also rephrase the IMHO clumsy "considering starting to use" with "contemplating the use of" 

Implementing both suggestions results in:
"
   The use of GitHub in IETF working group processes is increasing.
   This document describes possible uses and conventions for working
   groups which are using, or contemplating the use of GitHub.  It does not
   mandate any processes, and does not intend to change the processes
   used by current working groups.
"

Stephan