[DOC] add contributing

Author: Remi-Gau

CONTRIBUTING.md

@@ -0,0 +1,77 @@
+# Contributing to the BIDS website
+
+**Welcome to the BIDS website repository!**
+
+_We're so excited you're here and want to contribute._
+
+We hope that these guidelines are designed to make it as easy as possible to get involved.
+If you have any questions that aren't discussed below, please let us know
+by [opening an issue](https://github.com/bids-standard/bids-website/issues/new).
+
+If you are not familiar with Git ansd GitHub,
+check our [generic contributing guidelines](https://bids-website.readthedocs.io/en/latest/collaboration/bids_github/CONTRIBUTING.html).
+
+If you want to contribute to the BIDS website,
+make sure you also read the instructions below.
+
+## Serving locally
+
+### Requirements
+
+- python >= 3.10
+
+Even though this is not required, having `make` installed
+will make it easier to easily serve the website locally.
+
+### Install and serve
+
+Fork and clone the repository and its submodules
+
+```bash
+git clone https://github.com/YOUR_USER_NAME/bids-website.git --recurse-submodules
+```
+
+Create a virtual environment using `conda`, `venv` of what other environment management tool you prefer.
+
+Install all the dependencies.
+
+```bash
+pip install -r requirements.txt
+```
+
+Generate all the content required for the build.
+
+```bash
+make update
+```
+
+Serve the website with the mkdocs.
+
+```bash
+mkdocs serve
+```
+
+## Maintenance
+
+### Requirements
+
+Same as for the install but you will also need to install `tox`.
+
+```bash
+pip install tox
+```
+<!-- TODO find minimal version of node and npm -->
+For some quality checks and rare operations, you will need node.js and npm.
+
+## Update all files
+
+```bash
+make update
+```
+
+## Run all formatting / linting tools
+
+```bash
+tox
+make remark
+```

README.md

@@ -3,64 +3,3 @@
 # The one true BIDS website
 
 View it here: https://bids-website.readthedocs.io/en/latest/?badge=latest
-
-## Serving locally
-
-### Requirements
-
-<!-- TODO determines minimum python version -->
-- python 3.X
-
-## Install
-
-Clone the repo and its submodules
-
-```bash
-git clone https://github.com/bids-standard/bids-website.git --recurse-submodules
-```
-
-Create a virtual environment using `conda`, `venv` of what other environment management tool you prefer.
-
-Install all the dependencies.
-
-```bash
-pip install -r requirements.txt
-```
-
-Generate all the content require for the build.
-
-```bash
-make update
-```
-
-Serve the website with the mkdocs.
-```bash
-mkdocs serve
-```
-
-## Maintenance
-
-### Requirements
-
-Same automation will work better if you are on unix system and have make.
-
-Same as for the install but you will also need to install `tox`.
-
-```bash
-pip install tox
-```
-<!-- TODO find minimal version of node and npm -->
-For some quality checks and rare operations, you will need node.js and npm.
-
-## Update all files
-
-```bash
-make update
-```
-
-## Run all formatting / linting tools
-
-```bash
-tox
-make remark
-```