Merge pull request #188 from VSevagen/community-health

[docs] Add community health section

Author: vchrombie

docs/community-health/code-dev-activity.md

@@ -0,0 +1,18 @@
+---
+layout: default
+title: Code Development Activities
+nav_order: 4
+parent: Community Health
+has_children: true
+has_toc: true
+---
+
+# Understand the types and frequency of activities involved in developing code
+
+The goal of this area is to identify and understand the source code changes over
+time and the frequency of those changes over time. For example,
+
+- What changes were made to the source code during a specified period ?
+- How projects manage lifecycle of their version control branches ?
+- What is the sum of the number of lines touches( lines addes plus lines removed
+  ) in all changes to the source code during a certain period. ?

docs/community-health/code-dev-efficiency.md

@@ -0,0 +1,19 @@
+---
+layout: default
+title: Code Development Efficiency
+nav_order: 5
+parent: Community Health
+has_children: true
+has_toc: true
+---
+
+# Understand how efficiently activities around code development get resolved.
+
+The goal of this area is to identify how efficiently any code related activity
+get resolved. For example,
+
+- What is the time taken to merge a change request ?
+- How many change requests are present in a code change ?
+- What reviews of change requests ended up being declined during a certain
+  period ?
+- What is the ratio of change request accepted to rejected ?

docs/community-health/contributions.md

@@ -0,0 +1,13 @@
+---
+layout: default
+title: Contributions
+nav_order: 1
+parent: Community Health
+has_children: true
+has_toc: true
+---
+
+#  Identify what contributions are being made
+
+The goal of this area is to identify what kind of contributions (wiki edit,
+documentaion, bug fix) are being made to a project.

docs/community-health/index.md

@@ -0,0 +1,21 @@
+---
+layout: default
+title: Community Health
+permalink: /community-health
+nav_order: 6
+has_children: true
+has_toc: true
+---
+
+# Understanding Community health
+
+GrimoireLab is the platform through which community health can be monitored but
+what is community health and how can we define it ?
+
+Community health is the potential that a project can continue developing quality
+software. There are different ways that it can be evaluated. For example, we can
+analyze the health of a community through the code quality, the activity in the
+community ( are the contributors active, are the issues being resolved, the
+diversity of contributors) and the resources needed by the project.
+
+Check out the following focus areas depending on your required metric.

docs/community-health/issue-resolution.md

@@ -0,0 +1,21 @@
+---
+layout: default
+title: Issue Resolution
+nav_order: 7
+parent: Community Health
+has_children: true
+has_toc: true
+---
+
+# Identify how effective community is at adressing issues from community participants
+
+The goal of this area is to identify how effective the community is at
+addressing issues from community participants. For example,
+
+- What is the number of new issues created during a certain period ?
+- What is the count of issues that showed activity during a certain period ?
+- What is the count of issues that were closed during a certain period ?
+- What is the average time that open issues have been open ?
+- What is the time period between the opening of an issue and a response in the issue
+  thread from another contributor ?
+- How much time taken to close an issue ?

docs/community-health/people.md

@@ -0,0 +1,17 @@
+---
+layout: default
+title: People
+nav_order: 3
+parent: Community Health
+has_children: true
+has_toc: true
+---
+
+# Understand personal engagement with projects
+
+The goal of this area is to identify and understand organizational and personal
+engagement with open source projects. For example,
+
+- Who are the contributors to your project ?
+- What is the geographical diversity of your contributors ?
+- What is the organizational diversity of your contributors ?

docs/community-health/time.md

@@ -0,0 +1,18 @@
+---
+layout: default
+title: Time
+nav_order: 2
+parent: Community Health
+has_children: true
+has_toc: true
+---
+
+# Identify when contributions are made
+
+The goal of this area is to identify when does contributions from organizations
+and people happen. For example,
+
+- What are the timestamps of contribution activities ?
+- What is the duration for the review of a change request ?
+- How much time for an activity (issue, change request) to receive any response
+  ?