Merge pull request #6240 from greg0ire/doc-headers

Use different toctrees for different sections

docs/en/sidebar.rst

@@ -1,22 +1,33 @@
-.. toctree::
-    :depth: 3
+.. toc::
 
-    reference/introduction
-    reference/architecture
-    reference/configuration
-    reference/data-retrieval-and-manipulation
-    reference/query-builder
-    reference/transactions
-    reference/platforms
-    reference/types
-    reference/schema-manager
-    reference/schema-representation
-    reference/security
-    reference/supporting-other-databases
-    reference/portability
-    reference/caching
-    reference/known-vendor-issues
-    reference/testing
+   .. tocheader:: Reference
+
+   .. toctree::
+      :depth: 3
+
+      reference/introduction
+      reference/architecture
+      reference/configuration
+      reference/data-retrieval-and-manipulation
+      reference/query-builder
+      reference/transactions
+      reference/platforms
+      reference/types
+      reference/schema-manager
+      reference/schema-representation
+      reference/security
+      reference/supporting-other-databases
+      reference/portability
+      reference/caching
+      reference/known-vendor-issues
+      reference/testing
+
+.. toc::
+
+   .. tocheader:: Explanation
+
+   .. toctree::
+      :depth: 3
 
     explanation/dc2type-comments
     explanation/implicit-indexes