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

doc: fix doc attribute scope #104

Merged
merged 2 commits into from
Jun 28, 2024
Merged

Conversation

eightfilms
Copy link
Contributor

@eightfilms eightfilms commented Jun 28, 2024

Applying the doc attribute without ! just applies it to the next item, and does not actually include the README.md. For example:

Screenshot 2024-06-28 at 7 53 13 PM

This PR fixes that by using #! instead to apply it to the entire scope, thus actually including the contents in the README.

With this PR:

Screenshot 2024-06-28 at 7 53 35 PM

To test, run cargo doc within ronkathon.

edit: the latex rendering within the html seems janky, but this could be fixed in a followup PR.

Applying the `doc` attribute without `!` just applies it to the next item, and does not actually include
the `README.md`.

This PR fixes that by using `#!` instead to apply it to the entire scope, thus actually including the contents in the README.
Copy link
Contributor

@0xJepsen 0xJepsen left a comment

Choose a reason for hiding this comment

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

nice good work

@eightfilms
Copy link
Contributor Author

fixed errors - doctests were running the poseidon examples from the README (which we now ignore with cfg_attr)

@0xJepsen 0xJepsen merged commit 9aa7718 into pluto:main Jun 28, 2024
4 checks passed
@github-actions github-actions bot mentioned this pull request Jul 1, 2024
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.

2 participants