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

Reference Enums rather than describing the specific values. #191

Open
dalonsoa opened this issue Jan 24, 2025 · 0 comments
Open

Reference Enums rather than describing the specific values. #191

dalonsoa opened this issue Jan 24, 2025 · 0 comments
Labels
documentation Improvements or additions to documentation

Comments

@dalonsoa
Copy link
Collaborator

This "with valid values..." comment is made in multiple docstrings and is essentially just referencing the values in the Enum used. If these Enums ever change these docstring will also need to be updated, which can easily be missed. Maybe it's best to just reference the Enum? This can be done quite seamlessly with a link in the docs if we're using mkdocstrings.

Originally posted by @AdrianDAlessandro in #125 (comment)

@dalonsoa dalonsoa added the documentation Improvements or additions to documentation label Jan 24, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

No branches or pull requests

1 participant