Refactor #113: Rework all documented API examples to be doctests so that we can ensure they are accurate

Actions

Send by e-mail Copy link

Refactor #113

closed

Rework all documented API examples to be doctests so that we can ensure they are accurate

Added by rbarlow almost 10 years ago. Updated over 5 years ago.

Status:

CLOSED - WONTFIX

Priority:

Normal

Assignee:

Category:

Sprint/Milestone:

Start date:

Due date:

% Done:

Estimated time:

Platform Release:

Groomed:

Sprint Candidate:

Tags:

Documentation, Pulp 2

Sprint:

Quarter:

Description

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.

Actions

Copy link

Updated by bmbouter over 9 years ago

Category deleted (1)
Tags Documentation added

Documentation is now a Tag not a Category.

Actions

Copy link

Updated by bmbouter over 5 years ago

Status changed from NEW to CLOSED - WONTFIX

Actions

Copy link

Updated by bmbouter over 5 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.

Actions

Copy link