documentation versioning

[oliver-sanders]

We should make the documentation available for multiple versions of Cylc and adopt a build directory structure similar to Rose.

Now that we have split Cylc into multiple decoupled components this is a little awkward but I would suggest the Cylc Flow version is the one which matters for the documentation.

Versioning documentation is pretty simple, change the directory structure so that documentation is built under a version directory, in Rose we have:

sphinx/
    # the documentation source files
    conf.py
    index.rst
    ...
doc/
    # the built documentation
    formats.json  # file listing versions and formats for the theme to present as options.
    2019.01.0/
        html/
            index.html
            ...
        slides/
            index.html
            ...
        pdf/
            index.html
            tutorial.pdf
            ...
    2018.06.0/
         ...

[kinow]

👍 and I think using Setuptools is not necessary, unless others find it useful. As this repo will start blank with the old content. The whole build structure can be make, setuptools, ant, etc. Whatever works the best here.

[oliver-sanders]

The whole build structure can be make, setuptools, ant, etc

The standard approach is to use the default Sphinx makefile produced by sphinx quickstart. We shouldn't need to adapt it too much.

[oliver-sanders]

closed by #26