added instructions to maintainers

Author: meleu

README.md

@@ -2,4 +2,57 @@
 
 Files needed to generate [RetroAchievements.org documentation pages](https://retroachievements.github.io/docs/)
 
-More info about how it works [here](https://github.com/RetroAchievements/docs/wiki/About).
+The **RetroAchievements Documentation Project** is divided into two parts:
+
+1. **[RAwiki](https://github.com/RetroAchievements/docs/wiki/)**
+2. **[RAdocs](https://retroachievements.github.io/docs/)**
+
+The wiki is where the documents are created and edited. Anyone (with a github account) is able to edit the wiki's content. Then, if you have something to share, please edit the wiki!
+
+The [RAdocs](https://retroachievements.github.io/docs/) website has (almost) the same content as the wiki, but with a more pleasant look. The content of this website is generated by its maintainers using the wiki's content as input.
+
+**When a change is made in the wiki this change is NOT instantaneously reflected in the docs.** The convertion is performed by a maintainer from time to time.
+
+
+## Generating RAdocs pages
+
+[No need to continue reading if you're not a RAdocs maintainer.]
+
+
+### dependencies
+
+**Windows**
+
+You'll need to install [Cygwin](https://cygwin.com/), and the following packages: `git`, `python3`, `python3-pip` and `libyaml-devel`.
+
+After installing the needed packages, perform this command:
+
+```
+pip install --upgrade mkdocs mkdocs-material
+```
+
+
+
+### cloning the repo
+
+After installing the dependencies, open a terminal and clone the repo with this command:
+
+```
+git clone --depth 1 --recursive https://github.com/RetroAchievements/docs
+```
+
+**Note**: don't forget the `--recursive` option.
+
+It creates a folder named `docs`. Just "enter" it using:
+
+```
+cd docs
+```
+
+
+### `generate-docs.sh`
+
+The `generate-docs.sh` is the script you'll be using to generate the pages for RAdocs. Run it with `--help` and see how it works. It's pretty straightforward.
+
+**Note**: only the wiki pages listed on the wiki's sidebar will be converted into RAdocs pages.
+