Skip to content

Conversation

@alexhroom
Copy link
Collaborator

This PR fixes the remainder of #5 by adding descriptions to all of the fields in Project and Controls. This format uses field docstrings which are loaded into the description model field attribute , meaning they can be picked up both by autodoc-pydantic for the documentation and can also be used in the GUI (e.g. for mouseover help text).

@alexhroom alexhroom requested a review from DrPaulSharp January 20, 2025 08:29
Copy link
Collaborator

@DrPaulSharp DrPaulSharp left a comment

Choose a reason for hiding this comment

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

All looks good, please review the descriptions I've commented on.

Also, what do you want to do regarding docstrings for the models - descriptions of the fields are already present of course, do you want to put them in this format?

@alexhroom alexhroom linked an issue Jan 22, 2025 that may be closed by this pull request
@alexhroom alexhroom merged commit 265668a into RascalSoftware:main Jan 22, 2025
7 checks passed
@alexhroom alexhroom deleted the controls-project-docstrings branch January 22, 2025 08:53
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.

Add Documentation for models and project

2 participants