add html meta stuff, MyST syntax, convert unordered list to a definition list, add new file to index, one sentence per line

Author: stevepiercy

docs/contributing/github-administration.md

@@ -1,18 +1,49 @@
+---
+myst:
+  html_meta:
+    "description": "GitHub administration for Plone"
+    "property=og:description": "GitHub administration for Plone"
+    "property=og:title": GitHub administration for Plone"
+    "keywords": "Plone, GitHub, administration"
+---
+
+(contributing-github-administration-label)=
+
 # GitHub administration
 
+This chapter describes how repositories under the Plone GitHub organization are managed.
+
+
+(contributing-github-repository-tagging-label)=
+
 ## Repository tagging
 
-To easily find repositories and what's their purpose within the Plone organization,
-a set of tags are being set on repositories within the Plone GitHub organization.
+To find repositories and their purpose within the Plone organization, a set of tags are used for repositories within the Plone GitHub organization.
+The following tags are in use.
+
+`core`
+: repositories that are required by both Volto and Classic UI projects
+
+`volto`
+: specific repositories that are required by Volto, but not Classic UI, projects
+
+`volto add-ons`
+: repositories that are not part of the default Volto installation, but extend its functionality
+
+`classic ui`
+: counterpart to `volto` tag
+
+`classic ui add-ons`
+: counterpart to `volto add-ons` tag
+
+`documentation`
+: repositories that have documentation
+
+`training`
+: repositories related to the training documentation
 
-The tags are so far:
+`infrastructure`
+: repositories used for maintaining Plone servers
 
-- `core`: any repository that are installed when doing a volto or a classic ui project, i.e. what's shared between the two
-- `volto`: specific repositories that are meant to get volto running
-- `volto add-ons`: repositories not part of default volto UI/UX but meant for it
-- `classic ui`: counterpart to volto tag
-- `classic ui add-ons`: counterpart to volto add-ons
-- `documentation`: repositories that have documentation
-- `training`: repositories related to the training documentation
-- `infrastructure`: repositories used for all about maintaining Plone servers
-- `tooling`: tools / apps needed to orchestrate Plone
+`tooling`
+: tools and applications needed to orchestrate Plone

docs/contributing/index.md

@@ -144,4 +144,5 @@ documentation/index
 ../plone.api/contribute/index
 ../plone.restapi/docs/source/contributing/index
 ../volto/contributing/index
+github-administration
 ```