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

docs(chpldoc): replace pragma 'no doc' with attribute #21915

Merged
merged 1 commit into from Mar 16, 2023

Conversation

arezaii
Copy link
Contributor

@arezaii arezaii commented Mar 16, 2023

This PR updates the chpldoc documentation to change the method for suppressing generated documentation from pragma "no doc" to @chpldoc.nodoc.

This required changing the code block style from Chapel to plain text as the sphinxcontrib-chapeldomain and pygments packages both require updates to parse attributes.

Future work will change these back to Chapel blocks once those updated packages are available.

TESTING:

  • build docs locally and inspect chpldoc page

reviewed by @lydia-duncan - thanks!

Signed-off-by: arezaii <ahmad.rezaii@hpe.com>
Copy link
Member

@lydia-duncan lydia-duncan left a comment

Choose a reason for hiding this comment

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

Looks good to me, thanks!

@arezaii arezaii merged commit bd5e250 into chapel-lang:main Mar 16, 2023
7 checks passed
arezaii added a commit that referenced this pull request Mar 16, 2023
…21916)

This PR updates deprecated docs to include the `@deprecated` attribute
instead of the `deprecated` keyword.

As with #21915, this required
changing the code block style from Chapel to plain text as the
sphinxcontrib-chapeldomain and pygments packages both require updates to
parse attributes.

Future work will change these back to Chapel blocks once those updated
packages are available.

TESTING:

- [x] build docs locally and inspect deprecation page

reviewed by @lydia-duncan - thank you!
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.

None yet

2 participants