Skip to content
Open
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
17 changes: 17 additions & 0 deletions GOVERNANCE.md
Original file line number Diff line number Diff line change
Expand Up @@ -144,3 +144,20 @@ new access controls for community.
* Setting security policies on the branches and repository.
* Setting any keys to the repsository.
* Integrating any new services, such as CICD to the repository.


## Editorial process
The editorial process diagram below describes how different roles interact with each other and what responsibilities they hold in the writing and updating of the specification. In principle, it's the responsibility of the contributors to raise issues in the specification document, and come up with a new change proposal.
Changes to the specification are done by forking the repository and making the changes first to their own repository, and creating a Pull Request against the original repository. The pull request is then reviewed by one or more editors. Editors may approve the PR directly, or propose additional changes. In case additional discussion is deemed necessary, a new ad hoc group can be formed to work on the issue. Discussion around issues usually happen in the community meetings or in separately agreed group meetings. Once the PR is approved, it is merged by the maintainers of the repository.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: add spacing


In short, the process to make changes is the following:
1. Fork repository
2. Make changes
3. Create Pull Request
4. Review Pull Request
5. Additional Changes
6. Approve Pull Request
7. Merge Pull Request

![ToIP Git process](https://user-images.githubusercontent.com/1370528/201668601-8858a595-80c3-4ee3-8f7c-f2821a890c57.png)

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would be good to link to the CONTRIBUTING.md file and reference that for more information. I.e The GOVERNANCE file shouldn't be the law for how to contribute, the CONTRIBUTING file should be I think.

The process stuff I would recommend to move over to the CONTRIBUTING.md file.