Merge branch 'add-gqm-gen' of github.com:InnerSourceCommons/managing-inner-source-projects into add-gqm-gen

Author: jeffabailey

.github/CODEOWNERS

@@ -0,0 +1 @@
+*       @InnerSourceCommons/ispo-working-group-trusted-committers

.github/vale/Vocab/Base/accept.txt

@@ -0,0 +1,16 @@
+omnichannel
+OSSWatch
+toolchain
+archivable
+
+# people
+Jono
+Bacon
+Karl
+Fogel
+
+# orgs
+Mattermost
+Atlasian
+Universidad
+Rey

.github/vale/Vocab/Base/reject.txt

@@ -0,0 +1,26 @@
+name: Spelling & Styles
+
+on:
+  push:
+    branches:
+    - main
+    paths:
+    - '**.md'
+  pull_request:
+    branches:
+    - main
+
+jobs:
+  vale:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v3
+
+    - name: Vale Linting
+      uses: errata-ai/vale-action@reviewdog
+      with:
+        files: '["introduction/", "infrastructure/", "measuring/"]'
+        vale_flags: "--glob=*.md"
+        filter_mode: added
+        debug: true

.github/workflows/vale.yml

@@ -0,0 +1,2 @@
+# We want to ignore our vale StylesPath
+.github/vale/*

.gitignore

@@ -0,0 +1,12 @@
+StylesPath = .github/vale
+MinAlertLevel = suggestion
+
+Packages = https://github.com/InnerSourceCommons/isc-styles/releases/latest/download/ISC.zip
+
+Vocab = Base
+
+[*]
+BasedOnStyles = ISC
+
+; If you **don't** want to check for the correct spelling of "InnerSource", comment this in
+; ISC.InnerSource = NO

.vale.ini

@@ -37,11 +37,11 @@ When using titles in Markdown, use # for main title, ## for the second header ti
 At that time this manual step will no longer be needed.
 
 [Goal-Question-Metric]: https://en.wikipedia.org/wiki/GQM
-[goals]: https://github.com/InnerSourceCommons/managing-inner-source-projects/tree/master/measuring/goals
-[questions]: https://github.com/InnerSourceCommons/managing-inner-source-projects/tree/master/measuring/questions
-[metrics]: https://github.com/InnerSourceCommons/managing-inner-source-projects/tree/master/measuring/metrics
-[goal template]: https://github.com/InnerSourceCommons/managing-inner-source-projects/blob/master/measuring/goals/gqm_goal_template.md
-[question template]: https://github.com/InnerSourceCommons/managing-inner-source-projects/blob/master/measuring/questions/gqm_question_template.md
-[metric template]: https://github.com/InnerSourceCommons/managing-inner-source-projects/blob/master/measuring/metrics/gqm_metric_template.md
-[edit the MermaidJS source]: https://github.com/InnerSourceCommons/managing-inner-source-projects/edit/master/measuring/use_gqm.md
-[graph]: https://github.com/InnerSourceCommons/managing-inner-source-projects/blob/master/measuring/use_gqm.md
+[goals]: https://github.com/InnerSourceCommons/managing-inner-source-projects/tree/main/measuring/goals
+[questions]: https://github.com/InnerSourceCommons/managing-inner-source-projects/tree/main/measuring/questions
+[metrics]: https://github.com/InnerSourceCommons/managing-inner-source-projects/tree/main/measuring/metrics
+[goal template]: https://github.com/InnerSourceCommons/managing-inner-source-projects/blob/main/measuring/goals/gqm_goal_template.md
+[question template]: https://github.com/InnerSourceCommons/managing-inner-source-projects/blob/main/measuring/questions/gqm_question_template.md
+[metric template]: https://github.com/InnerSourceCommons/managing-inner-source-projects/blob/main/measuring/metrics/gqm_metric_template.md
+[edit the MermaidJS source]: https://github.com/InnerSourceCommons/managing-inner-source-projects/edit/main/measuring/use_gqm.md
+[graph]: https://github.com/InnerSourceCommons/managing-inner-source-projects/blob/main/measuring/use_gqm.md

CONTRIBUTING.md

@@ -12,19 +12,18 @@ within this respect in a way that this is useful for third parties. For this, we
 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/master/CONTRIBUTING.md).
+You can find more information about the process in the [contributing section](https://github.com/dicortazar/managing-inner-source-projects/blob/main/CONTRIBUTING.md).
 
 ## Who is fostering this initiative?
 
-Bitergia, as neutral actor in the software development analytics field aims at
-sharing the knowledge acquire during the last years. This book is currently focused on its main areas of expertise such as the usual metrics and KPI's to use,
+We thank [Bitergia] (especially José Manrique López and Daniel Izquierdo) for starting this book and seeding it with its main areas of expertise such as the usual metrics and KPI's to use,
 the methodology, the metrics strategy around your general InnerSource strategy 
-or the infrastructure needed to have a successful InnerSource
-journey within your company.
+and the infrastructure needed to have a successful InnerSource
+journey within a company.
 
-This book is open to anyone interested in InnerSource, either you are 
-applying this and you want to share your use case or you have successfully 
-applied InnerSource in your internal software development process.
+The book is now managed by the [ISPO Working Group].
+It is open for use and contribution by anyone interested in InnerSource.
+Come join us and contribute!
 
 ## How Do We Structure Goals, Questions, and Metrics?
 
@@ -39,29 +38,21 @@ See the ["Metrics" section of CONTRIBUTING.md](./CONTRIBUTING.md#metrics).
 
 ## References
 
-For further reading, we encourage you to participate in the [InnerSource Commons site](https://paypal.github.io/InnerSourceCommons/)
-funded by PayPal where dozens of companies are already sharing experiences and working to
-understand all of this. It is a great place to understand how others are facing this
-new methodology as we are all learning from this incipient process.
-
-And finally, if you're interested in participating from a survey perspective and share
-your insights about this within your organization, please have a look at the
-[InnerSource Survey](https://paypal.github.io/InnerSourceCommons/assets/files/InnerSourceCommonsSurvey2016.pdf).
+For further reading, we encourage you to participate in the [InnerSource Commons],
+a non-profit foundation where dozens of companies are already sharing experiences and working to
+improve their craft of InnerSource.
 
 
 ## Acknowledgements
 
 Each chapter in the book is authored and reviewed by different people. That information can
-be found at the beginning of each chapter. This initiative is fostered by [Bitergia](https://bitergia.com)
-although given some technical issues, we finally decided to open this under a personal
-repository.
-
-For further questions, please contact José Manrique López or Daniel Izquierdo:
-(jsmanrique|dizquierdo) at bitergia dot com.
-
-
-Thanks for your time here!
+be found at the beginning of each chapter. This initiative is fostered by the [ISPO Working Group].
+For further questions, please contact us in [Slack](https://innersourcecommons.org/slack)!
 
 The book cover was created by [Sebastian Spier](https://spier.hu), using an image by user [Bru-nO](https://pixabay.com/photos/measure-unit-of-measure-meterstab-2737004/), available under the [Pixabay License](https://pixabay.com/service/license/).
 
 All of the content found in this repository is licensed [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/).
+
+[Bitergia]: https://bitergia.com/
+[ISPO Working Group]: https://innersourcecommons.org/community/#ispo
+[InnerSource Commons]: https://innersourcecommons.org/

README.md

@@ -6,34 +6,21 @@
   * [Framework](introduction/framework.md)
   * [Authors and Reviewers](introduction/authors.md)
 * [Infrastructure](infrastructure/infrastructure.md)
-  * [Basic Infrastructure](infrastructure/infrastructure.md#basic-infrastructure)
-    * [Development Process](infrastructure/infrastructure.md#development-process-infrastructure)
-    * [Communication Channels](infrastructure/infrastructure.md#communication-channels-infrastructure)
-    * [Monitoring](infrastructure/infrastructure.md#monitoring-infrastructure)
-  * [Comparing How Inner-Sourced Your Infra Is](infrastructure/infrastructure.md#comparing-how-inner-sourced-your-infrastructure-is)
+  * [Basic Infrastructure](infrastructure/basics.md)
+  * [Comparing How Inner-Sourced Your Infra Is](infrastructure/assessment.md)
   * [Authors and Reviewers](infrastructure/authors.md)
-* [What, When and How to Measure](measuring/introduction.md)
+* [What, When and How to Measure](measuring/measuring.md)
   * [Goals using Metrics](measuring/goals.md)
-    * [Use Goals, Questions, and Metrics](measuring/use\_gqm.md)
-      * [Goals](use\_gqm/goals/README.md)
+    * [Use Goals, Questions, and Metrics](measuring/use_gqm.md)
+      * [Goals](use_gqm/goals/README.md)
         * [Reduce Duplication](measuring/goals/reduce-duplication.md)
-      * [Questions](use\_gqm/questions/README.md)
+      * [Questions](use_gqm/questions/README.md)
         * [Who Uses](measuring/questions/who-uses.md)
-      * [Metrics](use\_gqm/metrics/README.md)
+      * [Metrics](use_gqm/metrics/README.md)
         * [Usage Count](measuring/metrics/usage-count.md)
   * [Areas of Analysis](measuring/areas.md)
   * [Goal-Question-Metric Approach](measuring/gqm.md)
   * [Strategy](measuring/strategy.md)
   * [Examples of Interest](measuring/metrics.md)
-    * [Mentorship and helping Newcomers](measuring/metrics.md#mentorships-and-helping-newcomers)
-    * [Development Cycle](measuring/metrics.md#development-cycle)
-    * [Contributors Funnel](measuring/metrics.md#contributors-funnel)
-    * [Engagement](measuring/metrics.md#engagement)
-    * [Break Silos](measuring/metrics.md#break-silos)
-    * [Spreading the Knowledge](measuring/metrics.md#spreading-the-knowledge)
-    * [Middle Management Cultural Change](measuring/metrics.md#middle-management-cultural-change)
-    * [Scalability](measuring/metrics.md#scalability)
-    * [Keep great Developers in House](measuring/metrics.md#keep-great-developers-in-house)
-    * [Allow Innovation in Detail](measuring/metrics.md#allow-innovation-in-detail)
   * [References](measuring/references.md)
   * [Authors and Reviewers](measuring/authors.md)