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

Additional Autodocs #471

Merged
merged 1 commit into from
Feb 13, 2025
Merged

Additional Autodocs #471

merged 1 commit into from
Feb 13, 2025

Conversation

voetberg
Copy link
Contributor

Auto generate documentation for policies, transfer protocols, transfer tools, and did_meta_plugins

Fine grained changes:

  • Adds generate_policy_documentation.sh file, to create 4 different html sites using mkdocs
  • Installs the package yq to update the yaml files - used to change the mkdocs.yml between making those new sites. Made the judgement that it's better to change the yaml and deal with an additional depedency than try to maintain 5 versions of roughly the same file
  • Changes the site used for the client api to the more descriptive client_api
  • Adds links in the sidebar for transfer tools and protocols, adds in-line links for did_meta and policies

Closes #368

@bari12 bari12 merged commit 4170b10 into rucio:main Feb 13, 2025
6 checks passed
@@ -28,6 +28,8 @@ VO. In this case, the configuration parameter or environment variable name
is suffixed with the VO name (for example, `package-vo1` or
`RUCIO_POLICY_PACKAGE_VO1`).

[The API for policy packages can be found here.](pathname:///html/rse_policies/rsemanager.html)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not sure if it could be confusing to call this the API for policy packages - most functions listed here https://rucio.github.io/documentation/html/rse_policies/rsemanager.html seem to be unrelated to policy packages

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.

Autodocs for Protocols, Policy Packages
3 participants