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
Build the docs with test.sh #858
Conversation
The test script is incorrectly named in our contributor docs. Fix it up with the correct name.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Should we really test docs on stable and not nightly with the docsrs
feature?
034d451
to
b353e35
Compare
Oh yes, cheers, that is much better. I'll patch |
Changes in force-push:
Also re-worded PR description. |
b353e35
to
140840d
Compare
Some code has only two spaces of indentation, we favour 4 in bash scripts.
We currently build the docs as a separate CI job, we can however just do it as part of the `Tests` job using the nightly toolchain. Conditionally build the docs based on a `DO_DOCS` env var. Note, uses `--cfg docsrs` so can only be built run with nightly toolchain.
140840d
to
0d36455
Compare
Changes in rebase: Remove the pinning changes because they were incorrect (and not anything to do with this PR). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
ACK 0d36455
0fd07ad Improve CI pipeline (Tobin Harding) Pull request description: We have unnecessary runs of the `test.sh` script. We can simplify the CI pipeline and at the same time improve the docs build by using `--cfg docsrs`. - Remove the `wasm` job, replace it by enabling the `DO_WASM` env var for the stable toolchain run in the `Tests` job. - Add `--cfg docrs` flag to the docs build and set the `DO_DOCS` env var as part of the nightly toolchain run in `Tests` job. The end result is one less run of the `test.sh` script and better test coverage. Idea came from @Kixunil when reviewing rust-bitcoin/rust-bitcoin#858, thanks. ACKs for top commit: apoelstra: ACK 0fd07ad Tree-SHA512: 063493ce03aa8cef5d7fc7636f3bfaaeff5c918d7076473bac23313082e8357d5282fcaf4d76a3dc5b0650e7ee43fa9d2b738f79863be7f24f2acf32f99da4b1
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
ACK 0d36455
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
ACK 0d36455
We currently build the docs as a separate CI job, we can however just do it as part of the
Tests
job using the nightly toolchain.Conditionally build the docs based on a
DO_DOCS
env var.Note, uses
--cfg docsrs
so can only be built run with nightly toolchain.ci.sh
->test.sh
inCONTRIBUTING.md
.test.sh
.Resolves: #850