Need documentation for low-level API for writing your own SQL
|Reported by:||Simon Willison||Owned by:||jacob|
|Has patch:||no||Needs documentation:||no|
|Needs tests:||no||Patch needs improvement:||no|
The Django database documentation doesn't currently describe the low-level API for writing your own SQL, using django.db.connection, cursors and so on. (It does explain the extra() clause on QuerySets which covers 80% of cases). Documentation for this should demonstrate writing custom model methods that run their own SQL queries, thus encouraging best practises.