Inital mkdocs for deluge

docs/development/documentation.md

@@ -0,0 +1,37 @@
+# Documentation
+
+## Sphinx
+We use Sphinx to create the documentation from docstrings in code.
+
+```
+pip install sphinx
+pip install sphinxcontrib-napoleon
+```
+
+The Sphinx config is located in `docs/conf.py`
+
+If new source files are added, auto-create the new `rst` files:
+
+```
+sphinx-apidoc -o docs/source/modules -T deluge deluge/tests
+```
+
+The manually updated `rst` files are:
+- `index.rst` - The index page for Deluge documentation
+- `docs/source/interfaces/` - User info on the different clients
+- `docs/source/core/` - Documentation of the DelugeRPC
+
+To build the docs:
+
+```
+python setup.py build_docs
+```
+
+### Notes
+There are two uses of `Mock` classes for catching/ignoring import errors:
+- In `conf.py` it is only applied to modules listed in `MOCK_MODULES`.
+- In `setup.py` it is used for any other `ImportError` or `Exception`. 
+
+## man pages
+
+Located in `docs/man`