ReadTheDocs compilation

[azmeuk]

This follows #299

It seems that there has not been a documentation compilation success for 3 years: https://readthedocs.org/projects/zodb/builds/

It seems only @jimfulton can solve this. Jim, would you consider giving the readthedocs access to someone else in the team?

Thanks in advance!

[jimfulton]

Done, I added @icemac.

[icemac]

It is bit confusing:

https://readthedocs.org/projects/zodb/builds/ is not the documentation built from this repository it belongs to http://github.com/cguardia/ZODB-Documentation.git

There are two RTD projects for zopefoundation/ZODB:

• https://readthedocs.org/projects/zodborg/ (used for https://www.zodb.org) (See also http://zodb.org is down #334.)
• https://readthedocs.org/projects/zodb-docs/ (Where I now have rights.)

Both were built two years ago for the last time. (I started a new build at https://readthedocs.org/projects/zodb-docs/builds/ – I am not sure why it does not run automatically – is the Guthub repository missing a Webhook? )

Maybe we could clean up this situation a bit.

[icemac]

https://zodb-docs.readthedocs.io now has the changes from #299 but https://zodb.org does not.

[azmeuk]

https://zodb.readthedocs.io/en/latest/ now displays the doc from https://github.com/zopefoundation/ZODB
cguardia/ZODB-Documentation#19

@icemac maybe https://zodb-docs.readthedocs.io/ is useless now?
Also, maybe we can change the URL displayed in the github repository to this one?

[icemac]

@azmeuk Thank you!
I just added a web hook, so https://zodb.readthedocs.io/ gets automatically updated.

https://github.com/zopefoundation/ZODB/blame/master/doc/index.rst#L45 still references the ZODB book at https://zodb.readthedocs.io/ – should it get a new URL or should we drop it from there?

I did not find a way for https://zodb-docs.readthedocs.io/ to redirect to https://zodb.readthedocs.io/ – so I'd delete it after https://www.zodb.org is based on https://zodb.readthedocs.io/ (See #336)