<div dir="ltr"><div><div><div><div><div><div><div>We have several problems w/ the Pulp3 docs currently, in decreasing order of severity.<br><br></div>1. We don't have docs per beta, we only have nightly docs [0]. This is a problem because during the beta cycle, when we make a backwards incompatible change in core's documentation, e.g. merging RQ work, plugins can't point there users to the core documentation that pairs wit the version of core they tested against. For example if we had core docs for beta1, beta2, beta3 ... and pulp_ansible was tested against beta2 only, pulp_ansible users should be able to browse the core docs at version beta 2. We currently can't do that.<br><br></div>2. The docs builder is uber complicated[1][2], strangely overlays content[3] from pulp-ci, and is still shared with pulp2. This is a hold-over from the pulp2 docs builders and we never cleaned them up. This has cost us some time recently.<br></div><br>3. The docs builder is on Jenkins which is not community accessible.<br><br></div>I think we should address this soon, but we need some ideas/discussion first.<br><br></div>I've thought of two ideas: move to Read The Docs or Move to Travis. After looking into it, RTD is a non-starter AIUI because RTD won't be able to install and start all of the services necessary like Travis can.<br><br></div>So to move to Travis we could: Enable a conditional publish so that any tag which publishes a build to PyPI also publishes the built docs to <a href="http://docs.pulpproject.org/">docs.pulpproject.org/</a> Additionally, we could configure Travis to publish with each merged commit as well so we would have continuous docs.<br><br></div><div>I want to check in on the urls. We need Travis to be able to build it from the tag or branch info. Would the url be like:<br><br><a href="https://docs.pulpproject.org/en/3.0/beta/3/">https://docs.pulpproject.org/en/3.0/beta/3/</a><br><br></div><div>Or like:<br><br><a href="https://docs.pulpproject.org/en/3.0/beta/3.0.0b3/">https://docs.pulpproject.org/en/3.0/beta/3.0.0b3/</a><br></div><div><br></div><div>Feedback and ideas are welcome. After some discussion I can incorporate all the ideas into a Redmine ticket.<br><br></div><div>-Brian<br></div><br><div><div><div><div><div><div><div><div><br>[0]: <a href="http://docs.pulpproject.org/en/3.0/nightly/">http://docs.pulpproject.org/en/3.0/nightly/</a><br>[1]: <a href="https://github.com/pulp/pulp-ci/blob/master/ci/jjb/jobs/docs.yaml#L72-L180">https://github.com/pulp/pulp-ci/blob/master/ci/jjb/jobs/docs.yaml#L72-L180</a><br>[2]: <a href="https://github.com/pulp/pulp-ci/blob/master/ci/docs-builder.py">https://github.com/pulp/pulp-ci/blob/master/ci/docs-builder.py</a><br>[3]: <a href="https://github.com/pulp/pulp-ci/tree/master/ci/docs">https://github.com/pulp/pulp-ci/tree/master/ci/docs</a><br></div></div></div></div></div></div></div></div></div>