build docs for PRs

[megies]

With the new Anaconda Python setup we have on our docs buildbot it would be rather unproblematic to have multiple builds running at the same time (in separate environments). I think it might be a good idea to have a cronjob running that frequently checks for updated PRs (using github API) and builds docs for them. This might especially help to judge the docs part of PRs by external contributors that do not build the docs locally for checking (for us and for them).

(A speedup of docs build time would certainly help for this one. E.g. by making client module images static and not request data via network -- at least for known to fail modules.)

Opinions? I think I'm gonna work on this when I find some time.

[krischer]

Very good idea and definitely helpful.

Regarding speeding up the tests: It might be possible to install some kind of hook or monkey patch and just record all network accesses during the doc building process and store it all in some directory. On subsequent runs that directory will be used to serve all requests and we can periodically update that repository.

We could also try to add one more travis build that just builds the docs and pushes it to some repository. I'm not sure if they would like that though.

[QuLogic]

VCR.py

[megies]

PR docs builds coming in one by one right now and will get updated automatically when pushed to.

see http://docs.obspy.org/pull-requests/

(leaving this issue open because I still have to add a cronjob that removes old, closed PRs' docs)

[megies]

Fence time for malformed docstrings etc. in new contributions soon is over, can be checked with one click soonish..

First manually created status message:

[krischer]

Beautiful!

[codecov-io]

Current coverage is 86.57%

Merging #1357 into master will not affect coverage as of ccae9a0

@@            master   #1357   diff @@
======================================
  Files          369     369       
  Stmts        49908   49908       
  Branches         0       0       
  Methods          0       0       
======================================
  Hit          43210   43210       
  Partial          0       0       
  Missed        6698    6698       

Review entire Coverage Diff as of ccae9a0

Powered by Codecov. Updated on successful CI builds.