Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Automatically generate the bootstrap config documentation #711

Draft
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

petrutlucian94
Copy link
Contributor

The bootstrap config documentation may get out of sync as a result of apiv1.BootstrapConfig changes.

To avoid this, we're going to automatically generate the documentation based on the apiv1.BootstrapConfig structure definition and docstrings.

This change adds the necessary tooling as part of the docgen package, which may be reused for other structures or projects.

@petrutlucian94 petrutlucian94 requested a review from a team as a code owner October 3, 2024 13:05
@petrutlucian94 petrutlucian94 marked this pull request as draft October 3, 2024 13:05
@petrutlucian94
Copy link
Contributor Author

The doc automation is ready, I need to add the missing docstrings to BootstrapConfig so that the tool can pick the description of each field.

The bootstrap config documentation may get out of sync as a result
of apiv1.BootstrapConfig changes.

To avoid this, we're going to automatically generate the documentation
based on the apiv1.BootstrapConfig structure definition and docstrings.

This change adds the necessary tooling as part of the ``docgen``
package, which may be reused for other structures or projects.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant