/
Git Hub - Collab Process

Git Hub - Collab Process

Step-by-step guide

Some details regarding github:

* Can use either a desktop client or the web client to access the repository

 

* Can have either a public repository (anyone can see it, but the owner

controls what commits are accepted; free), or a private repository (only

the owner and invited collaborators can see and commit to it; paid

subscription required) —

https://guides.github.com/introduction/getting-your-project-on-github/

 

For actual document editing:

Step one: A repository is created.

Step two: The owner of that repository adds the original, master copy of

the document (i.e., “mvcr-spec).

Step three: Individuals who want to contribute (change, add, remove)

text from the master copy creates a “fork" of the repository and after

editing, creates a pull request representing the proposed changes  This

gives them their own space within which to makes changes.  They might

call their copy “mvcr-spec-06"

Step four: The changes made to mvcr-spec-06 are “committed” back to

github, where others may review the new file, add comments or issues, or

even create a branch from that to offer their own text.

Step five: After the WG comes to consensus on a set of changes, the

forked copy will be “merged” back to the master file, and all changes

will be incorporated.  We will have a history of what changed, and can

run a diff to highlight those changes at any point in time in the future.

Step six: After a new master file is created, based on merging the pull

requests back into the master, the WG chair or the WG editor should

create a copy on the Kantara wiki.

  

For issue tracking:

* This might be used to help keep track of suggestions that come out of

the call, and could serve as a way to make sure we have properly and

publicly responded to the issues and comments received, and indicate in

which version of the spec those comments were addressed

 

* We can decide upon a set of labels (e.g., diagram, use-case,

technical, editorial) to help structure the list of issues.

 

* Note that anyone can create and view issues on free public

repositories; only teammates and collaborators can create and view

issues on private repositories

 

Filter by label

There are no items with the selected labels at this time.

Related content

Documentation Procedures
Documentation Procedures
More like this
WG DG Document Development Summary
WG DG Document Development Summary
More like this
Kantara Initiative Discussion Group or Working Group Project Outline
Kantara Initiative Discussion Group or Working Group Project Outline
More like this
ANCR Consensus Policy
ANCR Consensus Policy
More like this
ANCR WG 20230816-
ANCR WG 20230816-
More like this
ANCR WG 20230726
ANCR WG 20230726
More like this