From e4d8f6af7ffcebc17975c9ce9ac9f21744e69031 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C3=A9my=20Coutable?= <remy@rymai.me>
Date: Thu, 9 Aug 2018 11:25:50 +0200
Subject: [PATCH] Update TOC in CONRTIBUTING.md and
 doc/development/contributing/
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: Rémy Coutable <remy@rymai.me>
---
 CONTRIBUTING.md                               | 41 ++++++++++---------
 doc/development/contributing/design.md        |  9 ++++
 doc/development/contributing/index.md         | 37 +++++++++++++++++
 .../contributing/issue_workflow.md            | 23 +++++++++++
 .../contributing/merge_request_workflow.md    | 11 +++++
 5 files changed, 101 insertions(+), 20 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 8e60f05add64c..e68e3b9cab04e 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -21,36 +21,37 @@ _This notice should stay as the first item in the CONTRIBUTING.md file._
 <!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
 **Table of Contents**  *generated with [DocToc](https://github.com/thlorenz/doctoc)*
 
+- [Contributing Documentation has been moved](#contributing-documentation-has-been-moved)
 - [Contribute to GitLab](#contribute-to-gitlab)
 - [Security vulnerability disclosure](#security-vulnerability-disclosure)
+- [Code of conduct](#code-of-conduct)
 - [Closing policy for issues and merge requests](#closing-policy-for-issues-and-merge-requests)
 - [Helping others](#helping-others)
 - [I want to contribute!](#i-want-to-contribute)
+- [Contribution Flow](#contribution-flow)
 - [Workflow labels](#workflow-labels)
-    - [Type labels](#type-labels)
-    - [Subject labels](#subject-labels)
-    - [Team labels](#team-labels)
-    - [Release Scoping labels](#release-scoping-labels)
-    - [Bug Priority labels](#bug-priority-labels)
-    - [Bug Severity labels](#bug-severity-labels)
-        - [Severity impact guidance](#severity-impact-guidance)
-    - [Label for community contributors](#label-for-community-contributors)
-- [Implement design & UI elements](#implement-design-ui-elements)
+  - [Type labels](#type-labels)
+  - [Subject labels](#subject-labels)
+  - [Team labels](#team-labels)
+  - [Release Scoping labels](#release-scoping-labels)
+  - [Priority labels](#priority-labels)
+  - [Severity labels](#severity-labels)
+    - [Severity impact guidance](#severity-impact-guidance)
+  - [Label for community contributors](#label-for-community-contributors)
+- [Implement design & UI elements](#implement-design--ui-elements)
 - [Issue tracker](#issue-tracker)
-    - [Issue triaging](#issue-triaging)
-    - [Feature proposals](#feature-proposals)
-    - [Issue tracker guidelines](#issue-tracker-guidelines)
-    - [Issue weight](#issue-weight)
-    - [Regression issues](#regression-issues)
-    - [Technical and UX debt](#technical-and-ux-debt)
-    - [Stewardship](#stewardship)
+  - [Issue triaging](#issue-triaging)
+  - [Feature proposals](#feature-proposals)
+  - [Issue tracker guidelines](#issue-tracker-guidelines)
+  - [Issue weight](#issue-weight)
+  - [Regression issues](#regression-issues)
+  - [Technical and UX debt](#technical-and-ux-debt)
+  - [Stewardship](#stewardship)
 - [Merge requests](#merge-requests)
-    - [Merge request guidelines](#merge-request-guidelines)
-    - [Contribution acceptance criteria](#contribution-acceptance-criteria)
+  - [Merge request guidelines](#merge-request-guidelines)
+  - [Contribution acceptance criteria](#contribution-acceptance-criteria)
 - [Definition of done](#definition-of-done)
 - [Style guides](#style-guides)
-- [Code of conduct](#code-of-conduct)
-- [Contribution Flow](#contribution-flow)
 
 <!-- END doctoc generated TOC please keep comment here to allow auto update -->
 
diff --git a/doc/development/contributing/design.md b/doc/development/contributing/design.md
index 12597f7fbff4c..3c35c6bf5b357 100644
--- a/doc/development/contributing/design.md
+++ b/doc/development/contributing/design.md
@@ -1,3 +1,12 @@
+<!-- START doctoc generated TOC please keep comment here to allow auto update -->
+<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
+**Table of Contents**  *generated with [DocToc](https://github.com/thlorenz/doctoc)*
+
+- [Implement design & UI elements](#implement-design--ui-elements)
+- [Style guides](#style-guides)
+
+<!-- END doctoc generated TOC please keep comment here to allow auto update -->
+
 ## Implement design & UI elements
 
 For guidance on UX implementation at GitLab, please refer to our [Design System](https://design.gitlab.com/).
diff --git a/doc/development/contributing/index.md b/doc/development/contributing/index.md
index 36e6d63691229..fa6202e41a086 100644
--- a/doc/development/contributing/index.md
+++ b/doc/development/contributing/index.md
@@ -1,3 +1,40 @@
+<!-- START doctoc generated TOC please keep comment here to allow auto update -->
+<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
+**Table of Contents**  *generated with [DocToc](https://github.com/thlorenz/doctoc)*
+
+- [Contribute to GitLab](#contribute-to-gitlab)
+- [Security vulnerability disclosure](#security-vulnerability-disclosure)
+- [Code of conduct](#code-of-conduct)
+- [Closing policy for issues and merge requests](#closing-policy-for-issues-and-merge-requests)
+- [Helping others](#helping-others)
+- [I want to contribute!](#i-want-to-contribute)
+- [Contribution Flow](#contribution-flow)
+- [Workflow labels](#workflow-labels)
+  - [Type labels](#type-labels)
+  - [Subject labels](#subject-labels)
+  - [Team labels](#team-labels)
+  - [Milestone labels](#milestone-labels)
+  - [Bug Priority labels](#bug-priority-labels)
+  - [Bug Severity labels](#bug-severity-labels)
+    - [Severity impact guidance](#severity-impact-guidance)
+  - [Label for community contributors](#label-for-community-contributors)
+- [Implement design & UI elements](#implement-design--ui-elements)
+- [Issue tracker](#issue-tracker)
+  - [Issue triaging](#issue-triaging)
+  - [Feature proposals](#feature-proposals)
+  - [Issue tracker guidelines](#issue-tracker-guidelines)
+  - [Issue weight](#issue-weight)
+  - [Regression issues](#regression-issues)
+  - [Technical and UX debt](#technical-and-ux-debt)
+  - [Stewardship](#stewardship)
+- [Merge requests](#merge-requests)
+  - [Merge request guidelines](#merge-request-guidelines)
+  - [Contribution acceptance criteria](#contribution-acceptance-criteria)
+- [Definition of done](#definition-of-done)
+- [Style guides](#style-guides)
+
+<!-- END doctoc generated TOC please keep comment here to allow auto update -->
+
 ## Contribute to GitLab
 
 For a first-time step-by-step guide to the contribution process, see
diff --git a/doc/development/contributing/issue_workflow.md b/doc/development/contributing/issue_workflow.md
index 95e15cce242df..24001fc5c2bcc 100644
--- a/doc/development/contributing/issue_workflow.md
+++ b/doc/development/contributing/issue_workflow.md
@@ -1,3 +1,26 @@
+<!-- START doctoc generated TOC please keep comment here to allow auto update -->
+<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
+**Table of Contents**  *generated with [DocToc](https://github.com/thlorenz/doctoc)*
+
+- [Workflow labels](#workflow-labels)
+  - [Type labels](#type-labels)
+  - [Subject labels](#subject-labels)
+  - [Team labels](#team-labels)
+  - [Release Scoping labels](#release-scoping-labels)
+  - [Priority labels](#priority-labels)
+  - [Severity labels](#severity-labels)
+    - [Severity impact guidance](#severity-impact-guidance)
+  - [Label for community contributors](#label-for-community-contributors)
+  - [Issue triaging](#issue-triaging)
+  - [Feature proposals](#feature-proposals)
+  - [Issue tracker guidelines](#issue-tracker-guidelines)
+  - [Issue weight](#issue-weight)
+  - [Regression issues](#regression-issues)
+  - [Technical and UX debt](#technical-and-ux-debt)
+  - [Stewardship](#stewardship)
+
+<!-- END doctoc generated TOC please keep comment here to allow auto update -->
+
 ## Workflow labels
 
 To allow for asynchronous issue handling, we use [milestones][milestones-page]
diff --git a/doc/development/contributing/merge_request_workflow.md b/doc/development/contributing/merge_request_workflow.md
index 7a45ebc3743fb..452cf93732896 100644
--- a/doc/development/contributing/merge_request_workflow.md
+++ b/doc/development/contributing/merge_request_workflow.md
@@ -1,3 +1,14 @@
+<!-- START doctoc generated TOC please keep comment here to allow auto update -->
+<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
+**Table of Contents**  *generated with [DocToc](https://github.com/thlorenz/doctoc)*
+
+- [Merge requests](#merge-requests)
+  - [Merge request guidelines](#merge-request-guidelines)
+  - [Contribution acceptance criteria](#contribution-acceptance-criteria)
+- [Definition of done](#definition-of-done)
+
+<!-- END doctoc generated TOC please keep comment here to allow auto update -->
+
 ## Merge requests
 
 We welcome merge requests with fixes and improvements to GitLab code, tests,
-- 
GitLab