GitHub Integration and Tooling (git) Internet Drafts


      
 Working Group GitHub Administration
 
 draft-ietf-git-github-wg-configuration-07.txt
 Date: 13/04/2020
 Authors: Alissa Cooper, Paul Hoffman
 Working Group: GitHub Integration and Tooling (git)
 Formats: txt
The use of GitHub in IETF working group processes is increasing. This document describes uses and conventions for working groups which are considering starting to use GitHub. It does not mandate any processes, and does not require changes to the processes used by current and future working groups not using GitHub.
 Working Group GitHub Usage Guidance
 
 draft-ietf-git-using-github-06.txt
 Date: 19/03/2020
 Authors: Martin Thomson, Barbara Stark
 Working Group: GitHub Integration and Tooling (git)
 Formats: html xml txt
This document provides a set of guidelines for Working Groups that choose to use GitHub for their work. Note to Readers Discussion of this document takes place on the GitHub@ietf mailing list (ietf-and-github@ietf.org), which is archived at https://mailarchive.ietf.org/arch/search?email_list=ietf-and-github. Source for this draft and an issue tracker can be found at https://github.com/ietf-gitwg/using-github.


GitHub Integration and Tooling (git)

WG Name GitHub Integration and Tooling
Acronym git
Area General Area (gen)
State Active
Charter charter-ietf-git-01 Approved
Dependencies Document dependency graph (SVG)
Additional Resources
- GitHub
Personnel Chairs Christopher Wood 
Paul Hoffman 
Area Director Alissa Cooper 
Mailing list Address ietf-and-github@ietf.org
To subscribe https://www.ietf.org/mailman/listinfo/ietf-and-github
Archive https://mailarchive.ietf.org/arch/browse/ietf-and-github/
Jabber chat Room address xmpp:git@jabber.ietf.org?join
Logs https://jabber.ietf.org/logs/git/

Charter for Working Group

Many IETF working groups use external code repository services, primarily GitHub, in managing their work. Individual working groups, while continuing to operate within IETF guidelines for working group activity, have developed their own policies and practices for how they use these services. These policies and practices cover aspects such as: managing discussion between working group mailing lists and GitHub issues and pull requests; how text contributions are expected to be made; labeling and naming conventions; maintaining readable draft snapshots; using tooling and automation; informing participants about IETF policies; and others.

The GitHub Integration and Tooling (GIT) working group will select a set of such practices and document policies that support those practices. The policies will each detail how work is conducted by working groups that opt to follow the work practice. The goal is to provide both process and tooling support for working groups that choose to adopt the practices.

The documents produced by this group may apply to services similar to GitHub. However, documenting generalized policies that are designed to apply to multiple services or policies specific to services besides GitHub are out of scope for this working group. Pursuing such work requires a re-charter.

The documents produced by this group will not alter the Internet Standards Process (BCP 9). They will describe how to work within it. Whether working groups choose to use GitHub or the documented policies to support their work will remain entirely at their discretion.

The working group may also discuss tooling requirements in support of GitHub use. Decisions about implementing specific tooling needs will be undertaken by the IETF Tools Team in consultation with working group participants and other interested contributors.

Milestones

Date Milestone
1 Aug 2019 Work practice description and policy document(s) sent to IESG for publication as BCP