plone · stevepiercy · Apr 9, 2023 · Apr 9, 2023 · Apr 9, 2023 · Apr 9, 2023
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -24,7 +24,7 @@
 
 - Deleted duplicate import and fixed training URLs. @yahya-cloud [#4523](https://github.com/plone/volto/issues/4523)
 - Fix grammar in PR #4542. @stevepiercy [#4555](https://github.com/plone/volto/issues/4555)
-- Fix broken links at ReactJS.org. @stevepiercy [#4569](https://github.com/plone/volto/issues/4569)
+- Fix broken links at `ReactJS.org`. @stevepiercy [#4569](https://github.com/plone/volto/issues/4569)
 - Fix video warnings and link errors. @stevepiercy [#4578](https://github.com/plone/volto/issues/4578)
 
 

diff --git a/docs/source/cheatsheet.md b/docs/source/cheatsheet.md
@@ -14,7 +14,7 @@ myst:
 # Cheatsheet
 
 ```{seealso}
-{doc}`plone:contributing/myst-reference`
+{doc}`plone:contributing/documentation/myst-reference`
 ```
 
 

diff --git a/docs/source/conf.py b/docs/source/conf.py
@@ -119,7 +119,7 @@
     "spelling_wordlist.txt",
     "**/CHANGES.rst",
     "**/LICENSE.rst",
-    "developer-guidelines/branch-policy.md",
+    "contributing/branch-policy.md",
 ]
 
 html_extra_path = [

diff --git a/docs/source/developer-guidelines/Quanta.pdf → docs/source/contributing/Quanta.pdf b/docs/source/developer-guidelines/Quanta.pdf → docs/source/contributing/Quanta.pdf
diff --git a/.../developer-guidelines/acceptance-tests.md → docs/source/contributing/acceptance-tests.md b/.../developer-guidelines/acceptance-tests.md → docs/source/contributing/acceptance-tests.md
diff --git a/...er-guidelines/accessibility-guidelines.md → .../contributing/accessibility-guidelines.md b/...er-guidelines/accessibility-guidelines.md → .../contributing/accessibility-guidelines.md
diff --git a/...rce/developer-guidelines/branch-policy.md → docs/source/contributing/branch-policy.md b/...rce/developer-guidelines/branch-policy.md → docs/source/contributing/branch-policy.md
diff --git a/...developer-guidelines/design-principles.md → .../source/contributing/design-principles.md b/...developer-guidelines/design-principles.md → .../source/contributing/design-principles.md
diff --git a/docs/source/developer-guidelines/icons.md → docs/source/contributing/icons.md b/docs/source/developer-guidelines/icons.md → docs/source/contributing/icons.md
diff --git a/...urce/developer-guidelines/contributing.md → docs/source/contributing/index.md b/...urce/developer-guidelines/contributing.md → docs/source/contributing/index.md
@@ -1,10 +1,10 @@
 ---
 myst:
   html_meta:
-    "description": "A guide on how to contribute to Volto, the frontend for Plone."
-    "property=og:description": "A guide on how to contribute to Volto, the frontend for Plone."
-    "property=og:title": "Contributing to Volto"
-    "keywords": "Volto, Plone, frontend, React, guidelines"
+    "description": "How to contribute to Volto, the frontend for Plone."
+    "property=og:description": "How to contribute to Volto, the frontend for Plone."
+    "property=og:title": "How to contribute to Volto, the frontend for Plone."
+    "keywords": "Plone, Volto, contributing, developer, guidelines"
 ---
 
 (contributing-to-volto-label)=
@@ -33,11 +33,11 @@ In your report, please specify a few things:
 -   Include relevant screenshots, error messages, and stack traces.
 
 
-(contributing-sign-and-return-the-plone-contributor-agreement-label)=
+(contributing-volto-sign-and-return-the-plone-contributor-agreement-label)=
 
 ## Sign and return the Plone Contributor Agreement
 
-The Volto Team reviews pull requests only from people with a GitHub account who have signed and returned the {ref}`Plone Contributor Agreement <contributing-sign-and-return-the-plone-contributor-agreement-label>`, and subsequently been assigned to a Plone Team in GitHub.
+The Volto Team reviews pull requests only from people with a GitHub account who have signed and returned the {ref}`Plone Contributor Agreement <plone:contributing-sign-and-return-the-plone-contributor-agreement-label>`, and subsequently been assigned to a Plone Team in GitHub.
 
 
 (contributing-branch-policy-label)=
@@ -89,6 +89,38 @@ Specifically:
 -   {doc}`./acceptance-tests`
 
 
+(contributing-developer-guidelines-label)=
+
+## Developer guidelines
+
+Development and configuration of Volto is managed through your {ref}`choice of Plone installation method <install-index-choose-installation-method-label>`.
+You may choose to install Plone via {ref}`containers <install-containers-label>` or from its {ref}`packages <install-packages-1-label>`.
+
+```{todo}
+When referring to installation and configuration of Plone's backend, this part of the Volto documentation may have obsolete content.
+The most current information for installing and configuring Plone is in {ref}`install-index-label`.
+Please report any issues in the [Volto issue tracker](https://github.com/plone/volto/issues/).
+```
+
+```{toctree}
+:maxdepth: 1
+
+design-principles
+style-guide
+language-features
+linting
+react
+redux
+routing
+icons
+testing
+acceptance-tests
+accessibility-guidelines
+typescript
+volto-core-addons
+```
+
+
 (contributing-final-advice-label)=
 
 ## Final advice

diff --git a/...developer-guidelines/language-features.md → .../source/contributing/language-features.md b/...developer-guidelines/language-features.md → .../source/contributing/language-features.md
diff --git a/docs/source/developer-guidelines/linting.md → docs/source/contributing/linting.md b/docs/source/developer-guidelines/linting.md → docs/source/contributing/linting.md
diff --git a/docs/source/developer-guidelines/react.md → docs/source/contributing/react.md b/docs/source/developer-guidelines/react.md → docs/source/contributing/react.md
diff --git a/docs/source/developer-guidelines/redux.md → docs/source/contributing/redux.md b/docs/source/developer-guidelines/redux.md → docs/source/contributing/redux.md
diff --git a/docs/source/developer-guidelines/routing.md → docs/source/contributing/routing.md b/docs/source/developer-guidelines/routing.md → docs/source/contributing/routing.md
diff --git a/...ource/developer-guidelines/style-guide.md → docs/source/contributing/style-guide.md b/...ource/developer-guidelines/style-guide.md → docs/source/contributing/style-guide.md
diff --git a/docs/source/developer-guidelines/testing.md → docs/source/contributing/testing.md b/docs/source/developer-guidelines/testing.md → docs/source/contributing/testing.md
diff --git a/...source/developer-guidelines/typescript.md → docs/source/contributing/typescript.md b/...source/developer-guidelines/typescript.md → docs/source/contributing/typescript.md
diff --git a/...developer-guidelines/volto-core-addons.md → .../source/contributing/volto-core-addons.md b/...developer-guidelines/volto-core-addons.md → .../source/contributing/volto-core-addons.md
diff --git a/docs/source/developer-guidelines/index.md b/docs/source/developer-guidelines/index.md
diff --git a/docs/source/index.md b/docs/source/index.md
@@ -47,7 +47,7 @@ addons/index
 backend/index
 deploying/index
 upgrade-guide/index
-developer-guidelines/index
 user-manual/index
+contributing/index
 release-notes/index
 ```
diff --git a/news/4666.documentation b/news/4666.documentation
@@ -0,0 +1 @@
+Rename "Developer Guidelines" to "Contributing". @stevepiercy
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		Rename "Developer Guidelines" to "Contributing". @stevepiercy