Merge branch 'main' of github.com:InnerSourceCommons/managing-innersource-projects into add-mdbook

Author: jeffabailey

README.md

@@ -2,17 +2,29 @@
 
 ![Managing InnerSource Projects](managing-innersource-projects-cover.jpg)
 
-This book is intended to bring, from a managerial perspective, the several aspects needed
-when introducing InnerSource methodologies into enterprises.
+## What is this book about?
 
-This book is a work in progress process where anyone is more than welcome to contribute
+This book is intended to cover all aspects of managing an InnerSource Program at an organization.
+Pitching, starting, scaling, training, governance, infrastructure, metrics, motivation, and much more!
+If there is any explanation that you need in relation to your InnerSource Program, then this book is intended to have it.
+
+## How is the book structured?
+
+This book is divided into sections and articles, each of which cover one single aspect of an InnerSource Program.
+Articles should be relatively short and self-contained so that they can be read in any order and any amount and still be useful.
+Detailed explanation of InnerSource topics should go in the [InnerSource Patterns] book and be linked from the article here.
+Think of the articles in this book like either a conversational introduction/summary to a pattern or possible a journey showing how multiple patterns can be used together in an InnerSource Program.
+
+## Who can contribute?
+
+This book is a work in progress where anyone is more than welcome to contribute
 in any possible way. Ideas, comments, typos, full paragraphs or sections would be
 great. This repository aims at bringing specialized knowledge from the industry
 within this respect in a way that this is useful for third parties. For this, we are
 actively looking for reviewers that can help in this process.
 For those that have already contributed to the book, thanks a lot!
 
-You can find more information about the process in the [contributing section](https://github.com/dicortazar/managing-inner-source-projects/blob/main/CONTRIBUTING.md).
+You can find more information about the process in our [contributing section](./CONTRIBUTING.md).
 
 ## Who is fostering this initiative?
 
@@ -55,3 +67,4 @@ All of the content found in this repository is licensed [CC BY-SA 4.0](https://c
 [Bitergia]: https://bitergia.com/
 [ISPO Working Group]: https://innersourcecommons.org/community/#ispo
 [InnerSource Commons]: https://innersourcecommons.org/
+[InnerSource Patterns]: https://patterns.innersourcecommons.org/

introduction/framework.md

@@ -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.
 
 ## Technical infrastructure
 

tooling/innersource-tooling.md

@@ -4,6 +4,10 @@
 
 This documentation is a compilation of the essential settings and strategies necessary for implementing InnerSource inside an organization. It encompasses both overall strategic elements and specific points relating to SCM configuration.
 
+We also encourage you to read the OpenSSF's (Open Source Security Foundation's) 
+[Source Code Management Configuration Best Practices guide](https://best.openssf.org/SCM-BestPractices/)
+for a perspective focused entirely on security.
+
 ## Table of Contents
 
 ### GitHub