Adds Travis-CI for sphinx-build and linkcheck

[AyanSinhaMahapatra]

This adds test scripts to check build status of Spinx Documentation along with adding checks for broken links. Also fixes some broken links and updates doc_maintenance.rst

Signed-off-by: Ayan Sinha Mahapatra ayansmahapatra@gmail.com

[AyanSinhaMahapatra]

Hi, @DennisClark you'd have to activate Travis-CI for this repository and turn on the "Build Pushed Pull Request" after merging this PR. Builds passed on my forked repository, though first, it gave errors on a lot of broken links and other stuff, which had to be corrected. I have also updated the doc_maintenance.rst on how to run the build tests locally. Additionally, you could add the "Build-Status" badge for this repository.

[steven-esser]

@AyanSinhaMahapatra Have you tested with Travis CI yourself? Just wondering since I cannot see the results until this is merged and I create a Travis CI instance for our repo.

[steven-esser]

is there more sphinx can check here besides linkcheck? Or will any syntax errors be caught at the build step itself (sphinx-build)?

This needs to be clarified.

[AyanSinhaMahapatra]

@MaJuRG I activated Travis-CI for my fork of aboutcode and yes the build passed. Check my build here. Also, sphinx-build checks for syntactical errors, and other common errors (the makefile also does the same), I double checked myself again locally by inserting common/complex errors and it works.

[AyanSinhaMahapatra]

I'm working on more tests and what can be done (linting and setting standards), this is just some basic tests.

[steven-esser]

Ok should I wait to merge this then or do you wish to add those changes later?

[AyanSinhaMahapatra]

No, you need not wait to merge this PR. I'll add those in a separate PR later.