Issue #7045
Plugin Writer API Reference is out of date
Start date:
Due date:
Estimated time:
Severity:
2. Medium
Version:
Platform Release:
OS:
Triaged:
Yes
Groomed:
No
Sprint Candidate:
No
Tags:
Documentation
Sprint:
Sprint 79
Quarter:
Description
Background¶
There is a section in the docs called "Plugin API Reference" section here which is driven by this portion of the docs. The idea is that our plugin API uses .. automodule:: statements to bring in the object documentation as a full reference in this section.
It is very outdated
Solution¶
Ensure that all objects in the plugin API are correctly represented in the reference by adding automodule statements.
Associated revisions
History
#1
Updated by ipanova@redhat.com about 1 year ago
in order to fix the problem members should be specified as well.
$ git diff
diff --git a/docs/plugins/api-reference/tasking.rst b/docs/plugins/api-reference/tasking.rst
index 680c17dc7..5999c0c84 100644
--- a/docs/plugins/api-reference/tasking.rst
+++ b/docs/plugins/api-reference/tasking.rst
@@ -4,4 +4,5 @@ pulpcore.plugin.tasking
All models documented here should be imported directly from the ``pulpcore.plugin.tasking`` namespace.
.. automodule:: pulpcore.plugin.tasking
+ :members:
:imported-members:
#2
Updated by daviddavis about 1 year ago
- Triaged changed from No to Yes
- Sprint set to Sprint 76
Per triage
#3
Updated by rchan about 1 year ago
- Sprint changed from Sprint 76 to Sprint 77
#4
Updated by rchan about 1 year ago
- Sprint changed from Sprint 77 to Sprint 78
#8
Updated by mdellweg 11 months ago
- Status changed from POST to MODIFIED
Applied in changeset pulpcore|8ae0960841d7e515fdfed71b5edb561bb09af334.
Please register to edit this issue
.
Add :members: to plugin api reference
This includes all classes to the autogenerated API reference again.
fixes #7045 https://pulp.plan.io/issues/7045