Merge pull request #677 from anita-flegg/new-docs-wg

New docs wg

Author: ChrisMcGowan

toc/working-groups/WORKING-GROUPS.md

@@ -38,6 +38,7 @@ The current working groups are:
 - App Runtime Interfaces
 - App Runtime Platform
 - CF on K8s
+- Docs
 - Foundational Infrastructure
 - Paketo
 - Service Management
@@ -122,6 +123,24 @@ The GitHub repos this WG manages in the `cloudfoundry` GitHub organization are t
 | <img width="30px" src="https://github.com/gcapizzi.png"> | Giuseppe Capizzi       | VMware  | [@gcapizzi](https://github.com/gcapizzi) |
 
 
+## Docs
+
+Mission: To document the Cloud Foundry user experience.
+
+The GitHub repos this WG manages in the `cloudfoundry` GitHub organization are to be labeled with the `cff-wg-docs` topic.
+
+| Artifact                   | Link |
+| -------------------------- | ---- |
+| Charter                    | [docs.md](./docs.md)  |
+| Forum                      | [Video chat TBD]()  |
+| Community Meeting Calendar | TBD |
+| Meeting Notes              | [Google Doc TBD]()  |
+| Slack Channel              | [&#x23;cf-docs](https://cloudfoundry.slack.com/archives/C03B0T0D5) |
+
+| &nbsp;                                                   | Leads            | Company | Profile                                 |
+| -------------------------------------------------------- | ---------------- | ------- | --------------------------------------- |
+| <img width="30px" src="https://github.com/anita-flegg.png"> | Anita Flegg | VMware  | [@anita-flegg](https://github.com/anita-flegg) |
+
 ## Foundational Infrastructure
 
 Mission: To provide infrastructure automation and core capabilities shared across CF projects, including identity management, credential management, and integrated data services.

toc/working-groups/app-runtime-interfaces.md

@@ -376,33 +376,6 @@ areas:
   - cloudfoundry/ykk
   - cloudfoundry/app-runtime-interfaces-infrastructure
 
-- name: Docs
-  approvers:
-  - name: Chloe Hollingsworth
-    github: cshollingsworth
-  - name: Anita Flegg
-    github: anita-flegg
-  - name: Samia Nneji
-    github: snneji
-  - name: Ben Klein
-    github: fifthposition
-  - name: Ajayan Borys
-    github: HenryBorys
-  - name: Bob Graczyk
-    github: bobbygeeze
-  - name: Kelly OHara
-    github: kohara88
-  - name: Jason Andrew
-    github: VMWare-JasonAndrew 
-  repositories:
-  - cloudfoundry/docs-buildpacks
-  - cloudfoundry/docs-cf-cli
-  - cloudfoundry/docs-cloudfoundry-concepts
-  - cloudfoundry/docs-dev-guide
-  - cloudfoundry/docs-services
-  - cloudfoundry/docs-dotnet-core-tutorial
-  - cloudfoundry/app-runtime-interfaces-infrastructure
-
 - name: Java Tools
   approvers:
   - name: Daniel Mikusa

toc/working-groups/app-runtime-platform.md

@@ -138,32 +138,6 @@ areas:
   - cloudfoundry/workpool
   - cloudfoundry/wg-app-platform-runtime-ci
 
-- name: Docs
-  approvers:
-  - name: Max Hufnagel
-    github: animatedmax
-  - name: Chloe Hollingsworth
-    github: cshollingsworth
-  - name: Anita Flegg
-    github: anita-flegg
-  - name: Samia Nneji
-    github: snneji
-  - name: Ben Klein
-    github: fifthposition
-  - name: Ajayan Borys
-    github: HenryBorys
-  - name: Bob Graczyk
-    github: bobbygeeze
-  - name: Kelly OHara
-    github: kohara88
-  - name: Jason Andrew
-    github: VMWare-JasonAndrew 
-  repositories:
-  - cloudfoundry/docs-book-cloudfoundry
-  - cloudfoundry/docs-cf-admin
-  - cloudfoundry/docs-loggregator
-  - cloudfoundry/docs-running-cf
-
 - name: Garden Containers
   approvers:
   - name: Danail Branekov

toc/working-groups/docs.md

@@ -0,0 +1,71 @@
+# Docs: Working Group Charter
+
+## Mission
+
+To document the Cloud Foundry user experience.
+
+## Goals
+
+- Make a plan for regular reviews and updates
+- Update and maintain READMEs for all docs repos
+- Update and maintain CF book repo/Table of Contents
+- Update and maintain contribution guidelines
+
+
+## Scope
+
+- Merge and edit all doc changes
+- Update with the latest best practices for SEO
+- Remove out-dated information
+- Advise contributors on best practices
+
+## Non-Goals
+
+- Be responsible for component level documentation (e.g. Cloud Controller v3 docs).
+
+## Roles & Technical Assets
+
+```yaml
+name: Documentation
+execution_leads:
+- name: Anita Flegg
+  github: anita-flegg
+technical_leads:
+- name: Anita Flegg
+  github: anita-flegg
+bots: []
+areas:
+- name: Docs
+  approvers:
+  - name: Max Hufnagel
+    github: animatedmax
+  - name: Anita Flegg
+    github: anita-flegg
+  - name: Samia Nneji
+    github: snneji
+  - name: Ben Klein
+    github: fifthposition
+  - name: Ajayan Borys
+    github: HenryBorys
+  - name: Bob Graczyk
+    github: bobbygeeze
+  - name: Lora Boe
+    github: blora1
+
+  repositories:
+  - cloudfoundry/docs-book-cloudfoundry
+  - cloudfoundry/docs-cf-admin
+  - cloudfoundry/docs-loggregator
+  - cloudfoundry/docs-running-cf
+  - cloudfoundry/docs-bbr
+  - cloudfoundry/docs-credhub
+  - cloudfoundry/docs-uaa
+  - cloudfoundry/docs-buildpacks
+  - cloudfoundry/docs-cf-cli
+  - cloudfoundry/docs-cloudfoundry-concepts
+  - cloudfoundry/docs-dev-guide
+  - cloudfoundry/docs-services
+  - cloudfoundry/docs-credhub
+  - cloudfoundry/docs-dotnet-core-tutorial
+  - cloudfoundry/app-runtime-interfaces-infrastructure
+```

toc/working-groups/foundational-infrastructure.md

@@ -56,30 +56,6 @@ bots:
 - name: bbr-ci
   github: bbr-ci
 areas:
-- name: Docs
-  approvers:
-  - name: Chloe Hollingsworth
-    github: cshollingsworth
-  - name: Max Hufnagel
-    github: animatedmax
-  - name: Anita Flegg
-    github: anita-flegg
-  - name: Samia Nneji
-    github: snneji
-  - name: Ben Klein
-    github: fifthposition
-  - name: Ajayan Borys
-    github: HenryBorys
-  - name: Bob Graczyk
-    github: bobbygeeze
-  - name: Kelly OHara
-    github: kohara88
-  - name: Jason Andrew
-    github: VMWare-JasonAndrew 
-  repositories:
-  - cloudfoundry/docs-bbr
-  - cloudfoundry/docs-credhub
-  - cloudfoundry/docs-uaa
 - name: Credential Management (Credhub)
   approvers:
   - name: Peter Chen