Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Refactor governance content #69

Draft
wants to merge 2 commits into
base: main
Choose a base branch
from
Draft

Refactor governance content #69

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
3ff2dae
feat: link to governance.md
Jan 25, 2024
67d9286
Merge branch 'main' into governance-refactor
jeffabailey Jun 21, 2024
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
35 changes: 2 additions & 33 deletions introduction/framework.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -32,40 +32,9 @@ Let's introduce the *InnerSource framework*.

## Governance

According to the Business Dictionary, governance is defined as:
A core aspect of the InnerSource framework is the governance model. Good governance is essential for the success of any project, and InnerSource is no exception.

>Establishment of policies, and continuous monitoring
>of their proper implementation, by the members of the
>governing body of an organization. It includes the
>mechanisms required to balance the powers of the
>members (with the associated accountability), and
>their primary duty of enhancing the prosperity and
>viability of the organization

In open source, governance is described in the "governance
model" document, defined by [OSSWatch](http://oss-watch.ac.uk/resources/governancemodels) as:

>A governance model describes the roles that project participants
>can take on and the process for decision making within the project.
>In addition, it describes the ground rules for participation in the
>project and the processes for communicating and sharing within
>the project team and community

Usually the governance model is a written document containing:

- project goals

- work, management and collaboration infrastructures definition

- people roles and responsibilities definitions

- community support mechanisms

- decision making process policies description

- contribution process policies description

- monitoring policies and mechanisms description
Pick the right [governance standards and model](/governance/governance.md) for your organization.
Copy link
Collaborator Author

Choose a reason for hiding this comment

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

@rrrutledge @spier

Given this context, I question whether or not linking to this file is the right approach.

#40 (comment)

image

We need to fundamentally decide if a hard copy of this book is a project goal. If it is, then we need to refer to the content with footnotes as suggested.

Copy link
Contributor

Choose a reason for hiding this comment

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

I think that online book is what we're going for.

Copy link
Member

Choose a reason for hiding this comment

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

I would also say that an online book (effectively just a website) is our current target format.
gitbook provides us this format, as well as the possibility to do a PDF export, where links will likely be clickable as well.


## Technical infrastructure

Expand Down
Loading