This repository is the source for the docs that live at robolectric.org.
Make sure you are in the source branch before making changes. This is the default branch so git should put you there automatically.
Before submitting a pull request, view the docs locally to check that the content and layout are correct. One can do this by running:
middleman server
This will build the docs and make them available at localhost:4567. Once your pull request is accepted, the docs will be automatically built and pushed to the web by Travis CI.
When Robolectric is released, the source/javadocs directory needs to be updated. This can be done by grabbing the javadocs that were pushed to Maven Central and unjarring them into that directory.
This repository has 2 branches: source and master. The former is a middleman project that can generate the latter. With every commit that is made to the source branch, Travis CI runs middleman and deploys the results back to the master branch. It does this by using an OAUTH token belonging to the robolectric-travis-bot user, who only has permission to commit and push to this repository.