# A Spoonful of Django
Welcome to **A Spoonful of Django**, a continuously-evolving repository of best practices for the latest official version of Django.
This repository includes recommentations for coding styles, patterns, and decisions. While this repo is here to represent best practices (something that is very subjective at times), many developers may disagree with some or many of the choices listed here. There is no single, correct method for developing Django projects. Be sure to make your own decisions, if something recommended here isn't sitting right with you.
As you have probably noticed by now, this repo is very much a work in progress. If you have a suggestion or improvement, please open up an issue and submit a pull request. All contributions are welcome!
## Contents
1. [Coding Style](topics/coding_style.md)
2. Local Environments
3. Project Structure
4. App Design
5. Configuration Files (e.g. settings.py, requirements.txt, etc.)
6. Models / Databases
7. Views (General Best Practices)
* Function-Based Views
* Class-Based Views
8. Forms
9. Templates
10. Django Admin
11. User Model
12. Third-Party Packages
13. Testing
14. Documentation
15. Security
16. Utilities
17. Deployment
18. Miscellaneous
## To-Do
1. Add content
2. Add code examples