diff --git a/pages/08.on-boarding/docs.md b/pages/08.on-boarding/docs.rst
similarity index 50%
rename from pages/08.on-boarding/docs.md
rename to pages/08.on-boarding/docs.rst
index 6f26370b..c0ee336e 100644
--- a/pages/08.on-boarding/docs.md
+++ b/pages/08.on-boarding/docs.rst
@@ -1,19 +1,10 @@
----
-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**. 
+
+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**.
 
@@ -21,23 +12,24 @@ People need to be able to quickly determine how they can offer their skills, fin
 
 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