Added infos to Readme, Howto doku

Author: astroidex

README.md

@@ -30,11 +30,10 @@ Example
 ```bash
 
 cd /data
-git clone https://github.com/mapbender/mapbender-documentation.git
-cd mapbender-documentation
+git clone git clone git@github.com:mapbender/mapbender-documentation
 git checkout release/3.2.0
 
-ln -s /data/mapbender-documentation/_build/ mb-doc
+ln -s /data/mapbender-documentation/_build/ /var/www/html/mb-doc
 
 rm -Rf _build
 sphinx-build . _build -A version=3.2.0

en/documentation_howto.rst

@@ -10,7 +10,7 @@ You find the Mapbender Documentation at:
 
 https://doc.mapbender.org
 
-The Documentation is build from the mapbender-docmentation repository at Github. This repository is used to build and deploy the http://doc.mapbender.org website on a nightly base. The website code is generated using Sphinx, therefore the documentation source is written in Restructured Text.
+The Documentation is build from the mapbender-docmentation repository at Github. This repository is used to build and deploy the https://doc.mapbender.org website. The website code is generated using Sphinx, therefore the documentation source is written in Restructured Text.
 
 This HowTo concentrates on the build of the documentation at http://doc.mapbender.org.
 
@@ -47,25 +47,13 @@ Every language (en - english, de - german) has the same file structure.
       index.rst        # refers to TheBook, Developer's Book & the Bundle Documentation
       bundles.rst      # lists the chapters of this category - refers to rst files
       development.rst  # lists the chapters of this category - refers to rst files
-      thebook.rst      # lists the chapters of this category - refers to rst files
-      /book
-        ....
-        /development
+      /architecture
+      /development
+          ....
+      /functions
+          /backend
+          /basic
           ....
-      /bundles
-          /Mapbender
-            /CoreBundle
-              index.rst             # refers to the elements, entitiy & service documentation
-              template_element.rst  # template to use for new element documentation
-              /elements
-                legend.rst
-                ...
-              /services
-                ...
-            /WmsBundle
-              ...
-          /FOM
-            ...
 
 
 How to build the documentation via Sphinx?
@@ -77,14 +65,17 @@ To build the website locally, you need to install Sphinx. In Debian-based distri
 
 .. code-block:: bash
 
-  apt-get install python-sphinx
+    sudo apt-get install sphinx-common  python3-sphinx
+    sudo apt-get install pip3
+    sudo pip3 install sphinxcontrib-phpdomain
 
 
 You can then build the documentation by running
 
 .. code-block:: bash
 
-  sphinx-build . output
+    sphinx-build . _build -A version=3.2.0
+
 
 You can also use the generate.sh shell script if you like.
 
@@ -157,7 +148,7 @@ Here are the steps you have to do:
   # get the documentation files from github
   cd /data
   git clone git@github.com:mapbender/mapbender-documentation
-  cd /mapbender-documentation/en/bundles/Mapbender/CoreBundle
+  cd /mapbender-documentation/en/functions/basic
 
   # create a rst-file. Use the template for element documentation!
   cp template_element.rst elements/add_wms.rst
@@ -166,18 +157,22 @@ Here are the steps you have to do:
 
   # build the the documentation locally to see how your documentation looks like
   cd /data/mapbender-documentation/
-  sphinx-build . output
+  rm -Rf _build
+  sphinx-build . _build -A version=3.2.0
 
   # have a look at the documentation in your browser (example location). Is everything ok? Any changes needed?
-  file:///data/mapbender-documentation/output/index.html
+  ln -s /data/mapbender-documentation/_build/ /var/www/html/mb-doc
+  http://localhost/mb-doc/
 
   # add, commit and push your new file to the mapbender-documentation repository
   # replace <element_name> with the element name, dont forget to remove the <, >
-  git add en/bundles/Mapbender/CoreBundle/elements/<element_name>.rst
-  git commit -m 'new documentation for element <element_name>' en/bundles/Mapbender/CoreBundle/elements/<element_name>.rst
-  git push
+  git checkout -b feature/add_wms
+  git add en/functions/basic/add_wms.rst
+  git commit -m 'new documentation for element <element_name>'
+  git push --set-upstream origin feature/add_wms
 
   # get the actual files from the mapbender-documentation repository
+  git checkout master
   git pull