Revert "Tidy index.md, rename to dashes"

This reverts commit 428c1cb.

Author: stevepiercy

…edev/contributors-agreement-explained.md …edev/contributors_agreement_explained.mdcoredev/contributors-agreement-explained.md renamed to coredev/contributors_agreement_explained.md coredev/contributors-agreement-explained.md renamed to coredev/contributors_agreement_explained.md

@@ -1,25 +1,32 @@
 ---
 myst:
   html_meta:
-    "description": "Development of Plone"
-    "property=og:description": "Development of Plone"
-    "property=og:title": "Development of Plone"
-    "keywords": "Developing, Plone, Contributing"
+    "description": ""
+    "property=og:description": ""
+    "property=og:title": ""
+    "keywords": ""
 ---
 
-# Development of Plone
+% -*- coding: utf-8 -*-
 
-This part describes the process of development of Plone.
-It is primarily a technical resource for setting up your development environment, fixing bugs, and writing Plone Improvement Proposals (PLIPs).
+# Developing for Plone Core
 
+## Introduction
 
-## Plone Contributor Agreement
+This documentation describes the process for developing Plone.
+It is primarily a technical resource for setting up your core developer buildout, fixing bugs and writing plips.
 
-You must sign the [Plone Contributor Agreement](https://plone.org/foundation/contributors-agreement).
+### STOP!
 
-We can **NOT** accept pull requests from you until you have signed, returned, and been approved.
-Please don't put the code reviewers at risk and by ignoring this.
+Legally, you can **NOT** contribute code unless you have signed the {doc}`contributor agreement <agreement>`.
 
+This means that we can **NOT** accept pull requests from you unless this is done,
+please don't put the code reviewers at risk and do it anyways.
+
+Submitting the agreement is easy (and will soon be easier) and if you want quick access and are familiar with the community,
+go into {doc}`irc <culture>` and ask one of the repo admins to give you access with a scanned copy of the agreement.
+
+They will get you going as fast as possible!
 
 ## Contents
 
@@ -39,26 +46,18 @@ git
 package-dependencies
 ```
 
-
 ## Additional Material
 
-These are some documents used as reference for this documentation.
+These are some documents using as reference for this documentation.
 
 ```{toctree}
 :maxdepth: 1
 
-contributors-agreement-explained
+contributors_agreement_explained
 continous-integration
 roboto
 mrdeveloper
-plip-review
+plipreview
 ```
 
-```{todo}
-The style guides are ancient and need to be overhauled.
-```
-
-Documenation's style is guided by Vale and the Microsoft Style Guide.
-See [Contributing to Documentation](https://6.docs.plone.org/contributing/index.html#).
-
-Our coding style guides are located at the [Plone Style Guide](https://5.docs.plone.org/develop/styleguide/index.html section.
+Our coding style guides are located at the {doc}`Plone Style Guide </develop/styleguide/index>` section.