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

meta: CI publishes docs on master builds to GitHub Pages #210

Closed
hawkw opened this issue Jul 22, 2019 · 1 comment · Fixed by #278 or #322
Closed

meta: CI publishes docs on master builds to GitHub Pages #210

hawkw opened this issue Jul 22, 2019 · 1 comment · Fixed by #278 or #322
Labels
help wanted Extra attention is needed kind/maintenance

Comments

@hawkw
Copy link
Member

hawkw commented Jul 22, 2019

Feature Request

Motivation

It would be nice to auto-publish the master docs every time a commit is merged to master. This is especially helpful as there are a number of incubating nursery crates which have not been published to crates.io, and thus don't get published to docs.rs, but still see some use.

Proposal

I believe crate-ci/azure-pipelines#35 is tracking an upstream change to the CI configs that should hopefully make this easy. When that lands, we should add it to our build.

@hawkw hawkw added help wanted Extra attention is needed kind/maintenance labels Jul 22, 2019
hawkw added a commit that referenced this issue Aug 14, 2019
## Motivation

Currently, we link to RustDoc on docs.rs. This is built when a crate is
published to crates.io. In some cases, it is also valuable to publish
the documentation for the latest `master` branch, so that users using
git dependencies can see up to date docs.

## Solution

This branch adds a GitHub action that will build docs & publish them to
the `gh-pages` branch when source files change.

Closes: #210

* add pages publish action on master commits
* only rebuild when sources change

Signed-off-by: Eliza Weisman <[email protected]>
@hawkw hawkw reopened this Sep 4, 2019
@hawkw
Copy link
Member Author

hawkw commented Sep 4, 2019

The github action doesn't work.

@hawkw hawkw closed this as completed in #322 Sep 4, 2019
hawkw pushed a commit that referenced this issue Sep 4, 2019
chore: build and publish documentation for each branch.

This commit introduces support for:
- building and deploying documentation for the master branch
- building and deploying (preview) documentation for each pull request
  and for each PR
- adds a link in `README.md` pointing to the generated documentation
  for the master branch
- notes the per-PR documentation previews in `CONTRIBUTING.md`

Closes #210
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
help wanted Extra attention is needed kind/maintenance
Projects
None yet
1 participant