Create documentation note

Author: emmadesilva

docs/digging-deeper/navigation.md

@@ -294,6 +294,11 @@ For example: `_docs/getting-started/installation.md` will be placed in a group c
 
 >info Tip: When using subdirectory-based dropdowns, you can set their priority using the directory name as the array key.
 
+#### Dropdown menu notes
+
+Here are some things to keep in mind when using dropdown menus, regardless of the configuration:
+- Dropdowns take priority over standard items. So if you have a dropdown with the key `about` and a page with the key `about`, the dropdown will be created, and the page won't be in the menu.
+  - For example: With this file structure: `_pages/foo.md`, `_pages/foo/bar.md`, `_pages/foo/baz.md`, the link to `foo` will be lost.
 
 ## Digging Deeper into the internals
 

packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php

@@ -158,9 +158,6 @@ protected function getOrCreateGroupItem(string $groupName): NavigationGroup
             // so here we create a new instance to replace the base one, this
             // does mean we lose the destination as we can't link to them.
 
-            // Todo: Add note in documentation about this behavior
-            // Example file structure: _pages/foo.md, _pages/foo/bar.md, _pages/foo/baz.md, here the link to foo will be lost.
-
             $item = new NavigationGroup($group->getLabel(), [], $group->getPriority());
 
             $this->items->put($groupKey, $item);