From d8299587bf15c00c8b1f30783200ed0f75b0c939 Mon Sep 17 00:00:00 2001 From: Shubhankar Deshpande Date: Tue, 21 Aug 2018 01:59:14 -0700 Subject: [PATCH] Fix markup for governance.md (#152) --- governance.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/governance.md b/governance.md index c741f71742..d3b7fba2ef 100644 --- a/governance.md +++ b/governance.md @@ -1,20 +1,20 @@ -#Software for Open Networking in the Cloud - SONiC -##Governance +# Software for Open Networking in the Cloud - SONiC +## Governance -##Goals +## Goals The goal of governance for the project is to maintain and emphasize a technical meritocracy of contributors. Those who contribute the most and the best technical solutions, have the most influence in the direction of the project. An element of benevolent dictatorship exists per component and at an overall project level to keep the project successful and resolve conflict. -##Structure +## Structure The project consists of many repositories that will change over time as the project evolves. Each repository is expected to be self governing with a maintainer leading it. A key repository in the project is sonic-build. build-repo is the authoritative list of all the necessary source code repositories needed to create the official distribution of the project. -##Roles and responsibilities +## Roles and responsibilities - *Contributors* are people who have submitted work to the project. Work includes all kinds of tasking, including things like code, tests, code reviews, documentation, infrastructure and proposals. - *Maintainers* have permission to accept pull requests and merge them into the master branch of a given repository. @@ -24,12 +24,12 @@ per repository. and keep the project. Today the project leader is appointed by Microsoft. A new Project Leader is expected to be appointed by the Open Compute Project when it is accepted. -##Conflict Resolution +## Conflict Resolution Each repository is expected to resolve conflicts for itself and between dependent repositories. If a resolution cannot be found in a reasonable time, the issue will be escalated to the Project Leader who will help the teams find a solution to move the project forward. -###Example of conflict resolution +### Example of conflict resolution Let's say the link aggregation repositor(ies) (LACP) merge a change that is incompatible with the other parts of the project. At a minimum, the build-repo maintainer will detect this and continue to build with the older release of the LACP repo(s). The community discusses the changes.