Add the DockerSwarm doc in the main RTD

docs/contrib/docker-swarm.rst

+
+Docker Swarm
+============
+
+Docker Swarm is Docker's own orchestration system. It allows running and
+managing Docker containers as services. eHive can be packaged as docker
+image (see on the `Docker hub <https://hub.docker.com/r/ensemblorg/ensembl-hive>`__).
+It also has a `Meadow plugin <https://github.com/Ensembl/ensembl-hive-docker-swarm>`__
+to leverage the Docker Swarm API and use it like any job scheduler.
+
+Here is some documentation about setting this up.
+
+.. toctree::
+   :maxdepth: 8
+
+   docker-swarm/tutorial
+   docker-swarm/howto
+   docker-swarm/dev_notes
+

docs/index.rst

@@ -74,6 +74,10 @@ User documentation
    advanced_usage/slack
    advanced_usage/continuous_pipelines
 
+.. toctree::
+   :caption: External plugins
+
+   contrib/docker-swarm
 
 .. toctree::
    :caption: Appendix

docs/rtd_upgrade.sh

@@ -30,4 +30,7 @@ mkdir ../root
 for i in *.deb; do dpkg -x "$i" ../root/; done
 
 git clone --branch master --depth 1 https://github.com/Ensembl/ensembl.git ../ensembl
+git clone --branch master --depth 1 https://github.com/Ensembl/ensembl-hive-docker-swarm.git ../ensembl-hive-docker-swarm
 
+mkdir -p ../../../contrib/
+ln -s "$1/ensembl-hive-docker-swarm/docs" ../../../contrib/docker-swarm