Skip to content

Publish docs to gh-pages, add coveralls, update README #385

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

Merged
merged 3 commits into from
Jul 13, 2016

Conversation

posborne
Copy link
Member

See the commit messages for some additional details. This started out with just an update to publish the docs to gh-pages but snowballed into a few other changes along the way.

This moves things around a fair bit in the .travis.yml to be
more logically ordered and adds support for publishing docs
(on master) to gh-pages.  Code coverage is also calculated
and published to coveralls.io.

Travis is able to write to gh-pages on the github repository
via the GH_TOKEN environment variable stored in the travis
settings (marked as private).  This token is generated from
the github user 'rust-nix-bot' in order to avoid given access
to other repos associated with an actual user's account (this
practice is recommended by Github).

Other changes worth noting:
 - We now test fewer intermediate versions of rust
 - The existing logic to publish to Carl's S3 bucket have been removed.

Signed-off-by: Paul Osborne <osbpau@gmail.com>
@coveralls
Copy link

coveralls commented Jul 10, 2016

Coverage Status

Changes Unknown when pulling 4b2383a on posborne:gh-pages-docs into * on nix-rust:master*.

@posborne posborne force-pushed the gh-pages-docs branch 2 times, most recently from ef46dde to 9145625 Compare July 10, 2016 07:29
@posborne
Copy link
Member Author

r? @kamalmarhubi @fiveop When I started out, I was thinking that the docs weren't being updated at all. It looks like they might be after all.

So, reasons to move to Github Pages:

  • Don't need to worry abut maintaining the seperate S3 bucket (I believe this done by @carllerche now), although there probably is not a significant amount of work/cost here.
  • Access goes along with contributors.
  • Most other projects I have seen publish docs to gh-pages

Downsides:

  • Currently, we are just publishing the docs for Linux on x86_64 with the default options on master. We should be able to make OSX work fine, but we'll need to get a bit creative.

- Linux: [master](http://rustdoc.s3-website-us-east-1.amazonaws.com/nix/master/linux/nix/)
- OS X: [master](http://rustdoc.s3-website-us-east-1.amazonaws.com/nix/master/osx/nix/)
```rust,ignore
// libc api (unsafe, requires handing return code/errno)
Copy link
Contributor

Choose a reason for hiding this comment

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

handling?

@fiveop
Copy link
Contributor

fiveop commented Jul 12, 2016

Looks good, except for that typo! :) I think the benefits outweigh the drawbacks of switching to github pages.

@posborne
Copy link
Member Author

Looks good, except for that typo! :) I think the benefits outweigh the drawbacks of switching to github pages.

Cool, I'll fix that up. Was traveling yesterday.

posborne added 2 commits July 12, 2016 13:04
This started out as a small change to update the readme
to include an updated pointer to the documentation on
gh-pages and ended with a bit of an overhaul in order
to provide better information for people just checking
out nix for the first time.

Signed-off-by: Paul Osborne <osbpau@gmail.com>
Signed-off-by: Paul Osborne <osbpau@gmail.com>
@fiveop
Copy link
Contributor

fiveop commented Jul 13, 2016

@homu r+

@homu
Copy link
Contributor

homu commented Jul 13, 2016

📌 Commit 8f461ff has been approved by fiveop

homu added a commit that referenced this pull request Jul 13, 2016
Publish docs to gh-pages, add coveralls, update README

See the commit messages for some additional details.  This started out with just an update to publish the docs to gh-pages but snowballed into a few other changes along the way.
@homu
Copy link
Contributor

homu commented Jul 13, 2016

⌛ Testing commit 8f461ff with merge 1033385...

@homu
Copy link
Contributor

homu commented Jul 13, 2016

☀️ Test successful - status

@homu homu merged commit 8f461ff into nix-rust:master Jul 13, 2016
@kamalmarhubi
Copy link
Member

Big 👍 for this!

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.

5 participants