From c39d971f7872da0deed2f07e2f17e05bd59a27ff Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Gr=C3=A9goire=20Paris?= Date: Sun, 10 Dec 2023 20:11:48 +0100 Subject: [PATCH 1/2] Indent explanation under toctree Not sure if that can explain the bug, but let's not take any chances. --- docs/en/sidebar.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/en/sidebar.rst b/docs/en/sidebar.rst index dc35f8eb27d..4f344709194 100644 --- a/docs/en/sidebar.rst +++ b/docs/en/sidebar.rst @@ -29,5 +29,5 @@ .. toctree:: :depth: 3 - explanation/dc2type-comments - explanation/implicit-indexes + explanation/dc2type-comments + explanation/implicit-indexes From dd105e06c746333b13452b392b487807e8495b69 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Gr=C3=A9goire=20Paris?= Date: Sun, 10 Dec 2023 20:12:44 +0100 Subject: [PATCH 2/2] Switch to absolute paths There is a piece of code in doctrine-website that adds leading slash, and comes with a comment saying to remove that piece of code once all sidebar files are fixed. It does so only for directories named "reference", "tutorials" or "cookbook", which might explain why items under explanation disappear once you navigate deeper in the tree. --- docs/en/sidebar.rst | 36 ++++++++++++++++++------------------ 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/docs/en/sidebar.rst b/docs/en/sidebar.rst index 4f344709194..66c8e2dbed9 100644 --- a/docs/en/sidebar.rst +++ b/docs/en/sidebar.rst @@ -5,22 +5,22 @@ .. 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 + /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:: @@ -29,5 +29,5 @@ .. toctree:: :depth: 3 - explanation/dc2type-comments - explanation/implicit-indexes + /explanation/dc2type-comments + /explanation/implicit-indexes