-
Notifications
You must be signed in to change notification settings - Fork 380
Publish rustdocs to github pages #562
Publish rustdocs to github pages #562
Conversation
Co-authored-by: Denis Pisarev <denis.pisarev@parity.io>
@TriplEight Have you adjusted the repo settings so that the published rustdocs will actually be available at paritytech.github.io/cumulus ? Or if not, could you? |
Yeah, I did. Not sure though where is it supposed to host the docs from, for now it's set to |
with: | ||
github_token: ${{ secrets.GITHUB_TOKEN }} | ||
publish_branch: gh-pages | ||
publish_dir: ./target/doc |
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.
I'm not sure if ./target/doc
is correct, but let's try. GitHub has no other choice but ./root/
or ./docs
and the Action's doc (which should be compatible) says it should be ./public
.
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.
This is the directory where cargo doc
builds the docs to. ./public
is an example.
* Publish rustdocs to github pages * @TriplEight 's suggestions from code review Co-authored-by: Denis Pisarev <denis.pisarev@parity.io> Co-authored-by: Denis Pisarev <denis.pisarev@parity.io>
This PR adds a CI job that builds and published the rustdocs to github pages. Similar to crates.parity.io, https://paritytech.github.io/frontier/rustdocs/pallet_evm/, or https://purestake.github.io/moonbeam/moonbeam_runtime/index.html
This is useful when working on downstream code to have an API guide quickly available, especially since github will host it for free.
This will need a little bit of help from someone with some permissions on this repo to setup the publishing source as the
gh-pages
branch. docs