We’ve published our in-house coding conventions in a public Github repo: github.com/octoenergy/conventions. It contains guidelines for:
- Python and Django code;
- CSS and SASS;
- HTML templates for the web and email;
- Git usage.
There’s lots of useful information there: hard-won lessons from building a large platform and the challenges that come with it.
The document is constantly evolving. We continually reflect on our codebase and use the document to codify new conventions and patterns.
It’s useful as a reference in code-review comments, to provide the detailed reasoning behind design decisions.
We keep it in a public repo as we believe the conventions will be useful to other teams building large Django applications. Hopefully it will prove a valuable resource.
Please let us know if you find it useful.
- Our pull request conventions
- Patterns of flakey Python tests
- Integrating Asana and GitHub
- Durable database transactions in Django
- Python interfaces a la Golang
- Beware changing the "related name" of a Django model field
- Recommended Django project structure
- Using a custom Sentry client
- Improving accessibility at Octopus Energy
- Django, ELB health checks and continuous delivery
- Organising styles for a React/Django hybrid
- Testing for missing migrations in Django
- Hello world, would you like to join us?