Merge branch 'dev'

# Conflicts:
#	docs/source/jupyter/quantum-espresso.ipynb

.dockerignore

@@ -0,0 +1,7 @@
+.vscode/
+docs/build
+*.pyc
+build/
+dist/
+*.egg-info/
+.eggs/

.github/workflows/CODEOWNERS

@@ -0,0 +1,4 @@
+# follows the same pattern as .gitignore files
+# file/mask username1/email1 ... usernameN/emailN
+
+* @yoavnash @pablo-de-andres @kysrpex

README.md

@@ -3,27 +3,50 @@
 **dev** - [![Documentation dev](https://readthedocs.org/projects/simphony/badge/?version=dev)](https://simphony.readthedocs.io/en/latest/?badge=dev)
 
 # SimPhoNy docs
-To access the documentation, please visit: https://simphony.readthedocs.io/en/latest/
+To access the documentation, please visit: [https://simphony.readthedocs.io](https://simphony.readthedocs.io).
 
-If you find any error or problem with the documentation, please [create an issue](https://github.com/simphony/docs/issues)
+If you find any error or problem with the documentation, please [create an issue](https://github.com/simphony/docs/issues).
 
-## Local installation
-First, some requirements have to be manually installed:
-- [osp-core](https://github.com/simphony/osp-core)
-- pandoc
-- LaTeX requirements
-  ```shell
-  sudo apt install pandoc
-  sudo apt-get install texlive-latex-recommended \
-                     texlive-latex-extra \
-                     texlive-fonts-recommended \
-                     latexmk 
-  ```
+## Local Rendering
+### HTML
+A server will start, generate the docs and listen for changes in the source files.
+This can be done by using docker or installing the development environment directly on the you machine. Next are installation guides for Docker and Linux OS.
 
+#### Docker
+First, build the Docker image by running the following command:
+```shell
+$ docker build -f local_build.Dockerfile -t simphony-docs .
+```
+
+Then, start the program by running:
+```shell
+$ docker run --rm -v $PWD:/app -p 8000:8000 simphony-docs
+```
+
+#### Linux
+At an OS level (these commands work on Linux Debian):
+```shell
+$ sudo apt install pandoc graphviz default-jre
+$ sudo apt-get install texlive-latex-recommended \
+                       texlive-latex-extra \
+                       texlive-fonts-recommended \
+                       latexmk 
+```
+The python dependencies:
+```shell
+$ pip install -r requirements.txt
+```
 
-If you want to render the documentation locally, you can run:
+Now you can start the server and render the docs:
 ```
-python3 setup.py install
+$ sphinx-autobuild docs/source docs/build/html
 ```
+The documentation will be available on [`http://127.0.0.1:8000`](http://127.0.0.1:8000).
 
-This will render the html and generate a LaTeX pdf (in `docs/build/latex/SimPhoNy_docs.pdf`).
+
+### PDF (LaTeX)
+To generate a PDF of the documentation, simply run (from the root project folder):
+```sh
+make -C docs latexpdf
+```
+The generated PDF can be found under docs/build/latex/SymPhoNy_docs.pdf