diff --git a/docs/setup/setting-up-navigation.md b/docs/setup/setting-up-navigation.md index f86cceb8a..7f349b486 100644 --- a/docs/setup/setting-up-navigation.md +++ b/docs/setup/setting-up-navigation.md @@ -46,8 +46,17 @@ _Material for MkDocs is the only MkDocs theme offering this feature._ [:octicons-file-code-24: Source][6] ยท :octicons-unlock-24: Feature flag When _tabs_ are enabled, top-level sections are rendered in a menu layer below -the header for viewports above `1220px`, but remain as-is on mobile. They can be -enabled via `mkdocs.yml` with: +the header for viewports above `1220px`, but remain as-is on mobile.[^1] They +can be enabled via `mkdocs.yml`: + + [^1]: + Prior to version 6.2, navigation tabs had a slightly different behavior. + All top-level pages (i.e. all top-level entries that directly refer to an + `*.md` file) defined inside the `nav` entry of `mkdocs.yml` were grouped + under the first tab which received the title of the first page. This made + it impossible to include a top-level page (or external link) as a tab item, + as was reported in #1884 and #2072. From version 6.2 on, navigation tabs + include all top-level pages and sections. ``` yaml theme: