Table of Contents should show two levels
|Reported by:||adrian_nye||Owned by:||nobody|
|Severity:||Keywords:||Table of contents|
|Cc:||Triage Stage:||Design decision needed|
|Has patch:||no||Needs documentation:||no|
|Needs tests:||no||Patch needs improvement:||no|
Currently the TOC shows only top level headings. For example if you want the doc on QuerySets you have to know to click on "Models and Databases" and then you see "Making Queries". The word "Query" does not appear anywhere at the top level. It's unclear that some of the top level topics are single files, while others include a whole list of files.
A two level deep TOC would be better (and it is the standard in technical books). This has several advantages: first it is quicker to get to what you need. Second you can see how the doc is organized in one view. Third you see more key topics and it is easier to understand the scope of the top level terms.