Let's make it easy to contribute to this repository.
What do you mean exactly?
Setting up this repo locally is a bit complex atm, I think that we should improve on it. Did you manage to get it running with the middleman locally?
I think that the style should be:
For "how to contribute" I think it's worthwhile to describe how we would like to see contributions to this repository. It can be as simple as suggestions to open issues or offer pull requests. Something to show that the repo is open to public contributions, that is it maintained, and that this is a good place to discuss changes (as opposed to CocoaPods/CocoaPods, mailing lists, or some other venue).
Just having a couple of issues in place will probably also help. My goal is to try to make it easy for users, especially new users who have found a problem trying to use the docs, to report (or fix) the issue. Let's make sure they don't have to guess what to do.
I'll write up an example in a pull request when I have a chance.
Middleman setup is fine I think. If that does prove to be a barrier we could setup a CI build to maintain an "edge" version of the guides for live previews of pull requests but I would want to make sure that's worth the effort before getting carried away.
I agree with all of the above points on style. Hopefully we can show style by example in existing docs but I find it useful to have some basic guidelines to remind me of the context I'm writing in. Again I'll try to offer a pull request.
Closing as this has been superseded by the guides.