Add onboarding section

This PR fixes mautic#222  and adds the onboarding section to the new Community Handbook for Read the Docs.

pages/08.on-boarding/docs.md → pages/08.on-boarding/docs.rst

@@ -1,43 +1,44 @@
----
-title: On-boarding
-twitterenable: true
-twittercardoptions: summary
-articleenabled: false
-orga: {  }
-personenabled: false
-facebookenable: true
-taxonomy:
-    category:
-        - docs
----
-
-On-boarding new contributors effectively is a hugely important part of our community.  
-
-If new contributors feel welcomed, able to use their time effectively and make a real difference which is recognised by the community, **we all benefit**. 
+.. meta::
+   :title: On-boarding
+   :twitterenable: true
+   :twittercardoptions: summary
+   :articleenabled: false
+   :orga: {}
+   :personenabled: false
+   :facebookenable: true
+   :category: docs
+
+On-boarding
+===========
+
+On-boarding new contributors effectively is a hugely important part of our community.
+
+If new contributors feel welcomed, able to use their time effectively and make a real difference which is recognised by the community, **we all benefit**.
 
 They feel their time is well spent, the Mautic project benefits from their skills and expertise, and **we all move forward together**.
 
 People need to be able to quickly determine how they can offer their skills, find projects with open tasks, and be supported in making their first contributions.
 
 While each team will have some aspects of the on-boarding process in common, there are some elements which will be universal across all teams.
 
-## General on-boarding - tools
+General on-boarding - tools
+---------------------------
 
-1. Anybody involved with the Mautic Community will need a Slack account - go to [mautic.org/slack][mautic-slack] to sign up.
+1. Anybody involved with the Mautic Community will need a Slack account - go to `mautic.org/slack`_ to sign up.
 
-2. Anybody contributing to Mautic teams will need to have a Google account, so that they can save their work in the shared [Google Drive folder][google-drive].
+2. Anybody contributing to Mautic teams will need to have a Google account, so that they can save their work in the shared `Google Drive folder`_.
 
-3. The Mautic Community use Jira for task management in all teams. Go to [mautic.atlassian.net][mautic-jira] and sign up for a new account (free of charge). If you need any help please ask in #community on Slack.
+3. The Mautic Community use Jira for task management in all teams. Go to `mautic.atlassian.net`_ and sign up for a new account (free of charge). If you need any help please ask in #community on Slack.
 
-4. Anybody who is involved in code-based contributions will need to sign the Mautic Contributors Agreement, which can be done online [here][contributors-agreement].
+4. Anybody who is involved in code-based contributions will need to sign the Mautic Contributors Agreement, which can be done online `here`_.
 
-5. Anybody who is involved with code, QA, testing or providing feedback will need to have a GitHub account, sign up at [github.com][github-signup].
+5. Anybody who is involved with code, QA, testing or providing feedback will need to have a GitHub account, sign up at `github.com`_.
 
-[mautic-slack]: <https://mautic.org/slack>
-[google-drive]: <https://drive.google.com/drive/folders/1OrwJXmDrrlWK3f9nxRuru0YjS7-W-1-e?usp=sharing>
-[mautic-jira]: <https://mautic.atlassian.net>
-[contributors-agreement]: <https://www.mautic.org/contributor-agreement/>
-[github-signup]: <https://github.com/join>
+.. _mautic.org/slack: https://mautic.org/slack
+.. _Google Drive folder: https://drive.google.com/drive/folders/1OrwJXmDrrlWK3f9nxRuru0YjS7-W-1-e?usp=sharing
+.. _mautic.atlassian.net: https://mautic.atlassian.net
+.. _here: https://www.mautic.org/contributor-agreement/
+.. _github.com: https://github.com/join