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

Add rustdoc CI check #5041

Merged
merged 1 commit into from
Oct 26, 2021
Merged

Add rustdoc CI check #5041

merged 1 commit into from
Oct 26, 2021

Conversation

ytmimi
Copy link
Contributor

@ytmimi ytmimi commented Oct 23, 2021

Resolves #5038

rust-lang/rust builds now document rustfmt (rust-lang/rust#87119). The
build process is updated with doc checks to ensure that rustfmt doesn't
introduce warnings.

Warnings are treated as hard errors in rust-lang/rust and won't show
until bors tests the changes (refs rust-lang/rust#90087).

@ytmimi
Copy link
Contributor Author

ytmimi commented Oct 23, 2021

image
Looks like there was a warning in the rustdoc check job, but it didn't cause the job to fail. is that the right behavior?

Comment on lines 24 to 25
RUSTFLAGS: -D warnings
RUSTDOCFLAGS: --document-private-items --enable-index-page --show-type-layout --generate-link-to-definition -Zunstable-options
Copy link
Member

Choose a reason for hiding this comment

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

Looks like there was a warning in the rustdoc check job, but it didn't cause the job to fail. is that the right behavior?

Nah we'd definitely want the job to fail. Does moving -D warnings to rust doc flags make a different? Otherwise perhaps a set -e?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

You were right. I needed to move the -D warnings option to the RUSTDOCFLAGS! I just did, and the CI job now passes without issuing any warnings since it looks like you fixed the doc warning in 051e2b4

@calebcartwright
Copy link
Member

Also, I'd like to give you triage permissions so that you have access to label issues, if that's something you'd be interested in (and as always, no worries if not!). Feel free to ping me in Discord if you have questions

Resolves 5038

rust-lang/rust builds now document rustfmt (rust-lang/rust#87119). The
build process is updated with doc checks to ensure that rustfmt doesn't
introduce warnings.

Warnings are treated as hard errors in rust-lang/rust and won't show
until bors tests the changes (refs rust-lang/rust#90087).
@ytmimi
Copy link
Contributor Author

ytmimi commented Oct 25, 2021

I'm honored thank you! I'd definitely be interested in taking on some of the triage work. I have a few questions so I'll ping you on discord!

@calebcartwright
Copy link
Member

Thank you!

@calebcartwright calebcartwright merged commit d454e81 into rust-lang:master Oct 26, 2021
@ytmimi ytmimi deleted the ci-doc-check branch October 30, 2021 17:54
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 rustdoc CI check
2 participants