Wiki source code of Documentation Navigation Panel

Last modified by Eleni Cojocariu on 2026/03/19 08:02

author	version	line-number	content
		1	The documentation navigation is displayed in the left panel, as shown below:
		2
		3	{{image reference="documentation-navigation-panel.png" size="medium"/}}
		4
		5	The documentation interface includes two navigation panels:
		6
		7	1. The target selector (left panel), which lets users choose the documentation target (e.g., Users, Admins, Developers).
		8	1. The content navigation panel, which changes dynamically based on the selected target.(((
		9	Content navigation is achieved through the [[Document Tree macro>>extensions:Extension.Document Tree Macro]], which automatically lists pages alphabetically.
		10
		11	* Top-level tree node pages must be [[pinned>>xwiki:documentation.xs.user.base.page.view-page.pin-children-pages.WebHome]] according to their usability, relevance, and importance within the documentation.
		12	* [[Type landing pages>>Community.DocGuide.CreateLandingPages.WebHome]] are also be pinned in the Diataxis order, which is: Tutorial, How-to, Reference, Explanation.
		13	* Documentation pages can be pinned where it makes sense (e.g., when some pages would appear first if there's no pinning and it would nicer for reader to see other pages listed first) and it's up to the documentation writer to take that decision.
		14	)))

Documentation Guide