- Add a URL which is auto inserted into README command.
- Use markdown as the preferred markup language - good github support
- Keep first section short to one screenfull => approx 15 lines.
- Second section is always Usage.
- Review audit, iris, rain, colorize, or objects for examples.