monsoonco/guides

A guide for programming in style.

Guides

Guides for getting things done, programming well, and programming in style.

• Protocol
  • Git
  • Rails
  • iOS
  • Open Source
• Code Review
• Best Practices
• Style

High level guidelines:

• Be consistent.
• Don't rewrite existing code to follow this guide.
• Don't violate a guideline without a good reason.
• A reason is good when you can convince a teammate.

A note on the language:

• "Avoid" means don't do it unless you have good reason.
• "Don't" means there's never a good reason.
• "Prefer" indicates a better option and its alternative to watch out for.
• "Use" is a positive instruction.

Contributing

Please read the contribution guidelines before submitting a pull request.

In particular: if you have commit access, please don't merge changes without waiting a week for everybody to leave feedback.

Credits

Guides is maintained by monsoon.

This style guide was forked from thoughtbot, inc.