Create a Travis continuous integration script for documentation

[kalxas]

Since the documents are now hosted under git (and mirrored on GitHub) we can take advantage of the Travis continuous integration capabilities and catch any build errors before merging new code.

[kalxas]

Ticket retargeted after milestone closed

[tomkralidis]

As per ​http://osgeo-org.1560.x6.nabble.com/OSGeoLive-10-0-status-rc1-td5277519.html what is the status of this process? It would be valuable to have a continuous deployment of the docs to ​http://adhoc.osgeo.osuosl.org/livedvd/docs/en/index.html. This would make things much easier for contributors to review.

[kalxas]

I agree. Unfortunately, the build cron job is broken due to changes to the Makefile.

We should be using the daily launchpad builds now for doc preview:

​https://launchpad.net/~osgeolive/+archive/ubuntu/docs

[tomkralidis]

How can we fix this?

[kalxas]

Sorry, I am not the owner of that cron job and I do not have access.

[cvvergara]

An idea of how this can be done: A .travis.yml is needed and the steps:

• Operative system for the test
• Install: the necessary packages to generate the documentation
• Script or after_success: execute the process to make the documentation

if in "Script" and there are errors then the build fails if in "after_success" and there are errors the build pass

When I added the translation for pgRouting quickstart I saw that making the documentation generates a lot of errors, So, my suggestion is first make the documentation error free, before putting it in the "script" stage.

When does that get tested: if the user has a travis account, it will start the test in his account. when a pull request is done it will start the the travis in the account of the repository where its requested.

These lines test the documentation of pgRouting generated with sphinx (only the html and in the after_success) ​https://travis-ci.org/cvvergara/pgrouting/jobs/147340825#L1751

[strk]

Consider also testing the Gogs-associated Drone service: drone.osgeo.kbt.io (currently hosted by myself but we might move it to OSGeo machines one day) -- you can login with your OSGeo Userid.

[kalxas]

Ticket retargeted after milestone closed

[kalxas]

This is already implemented as part of the work done by Vicky in her development branch:

​https://github.com/cvvergara/OSGeoLive-doc/commits/test/sphinx

[cvvergara]

The ticket is about travis for documentation, and that is done. Any more contents of travis, open a new ticket.

[kalxas]

Thanks Vicky!