docs: Add how to write documentation

Author: ukkopahis

.github/workflows/main.yml

@@ -13,5 +13,5 @@ jobs:
       - uses: actions/setup-python@v2
         with:
           python-version: 3.x
-      - run: pip install mkdocs-material
+      - run: pip3 install -r requirements-mkdocs.txt
       - run: mkdocs gh-deploy --force

docs/Developers/Contributing-Services.md renamed to docs/Developers/Contributing.md

@@ -1,6 +1,22 @@
-# Contributing a service to IOTstack
+# Contributing
 
-On this page you can find information on how to contribute a service to IOTstack. We are generally very accepting of new services where they are useful. Keep in mind that if it is not IOTstack, selfhosted, or automation related we may not approve the PR.
+## Writing documentation
+
+Documentation is is written as markdown, processed using mkdocs ([docs](https://www.mkdocs.org/user-guide/writing-your-docs/#writing-your-docs)) and the Material theme ([docs](https://squidfunk.github.io/mkdocs-material/reference/)). The Material theme is not just styling, but provides additional syntax extensions.
+
+Setup your system for mkdocs and Material:
+```
+pip3 install -r requirements-mkdocs.txt
+```
+
+To test your local changes while writing them and before making a pull-request:
+```
+mkdocs serve
+```
+
+## Creating a new service
+
+In this section you can find information on how to contribute a service to IOTstack. We are generally very accepting of new services where they are useful. Keep in mind that if it is not IOTstack, selfhosted, or automation related we may not approve the PR.
 
 Services will grow over time, we may split up the buildstack menu into subsections or create filters to make organising all the services we provide easier to find.
 

docs/index.md

@@ -10,4 +10,4 @@ Welcome to the IOTstack Wiki:
 
 * If you are just getting started with IOTstack, see [Getting Started](./Getting-Started.md).
 
-* To contribute see [Contributing Services](Developers/Contributing-Services.md)
+* To contribute see [Contributing](Developers/Contributing.md)

requirements-mkdocs.txt

@@ -0,0 +1,3 @@
+mkdocs-material
+mkdocs-material-extensions
+mkdocs-redirects