Rework all documented API examples to be doctests so that we can ensure they are accurate
It is very common for our API examples in the documentation to become inaccurate as we make changes. Sphinx has the ability to ensure that examples are accurate against the current code if we format our rst files correctly. We should take advantage of this feature so that when we build the docs our examples are checked for accuracy. We should also have run-tests.py run the doctests.
Updated by bmbouter almost 4 years ago
Pulp 2 is approaching maintenance mode, and this Pulp 2 ticket is not being actively worked on. As such, it is being closed as WONTFIX. Pulp 2 is still accepting contributions though, so if you want to contribute a fix for this ticket, please reopen or comment on it. If you don't have permissions to reopen this ticket, or you want to discuss an issue, please reach out via the developer mailing list.