Understand the structure of dolittle documentation
All documentation is inside Dolittles Documentation repositorys
Source folder. The 2 main pieces of this folder are
Source/repositoriescontain submodules to Dolittle repositories.
Source/contentis the folder that Hugo uses to render dolittle.io, making it the root of the pages. It contains documentation and symlinks to each
Source/repositoriessubmodules Documentation folder.
Defining folder hierarchy on dolittle.io
To add structure (sub-folders) to the content folder and make these visible, Hugo expects an
_index.md inside the subfolders. The
_index.md files acts as a landing page for the subfolder and should contain a Front Matter section. This defines the title, description, keywords & relative weighting in its parent tree.
--- title: Page Title description: A short description of the pages contents keywords: comma, separated, keywords, to, help, searching author: authorname weight: 2 ---
_index.md files within subfolders should only contain the Front Matter and nothing else unless needed. This makes the subfolder links on the sidebar work as only dropdowns without linking to the content of the _index.md. We prefer this as it makes for a more smooth experience on the site.
You should only have an _index.md file for the uppermost landing page of dolittle.io like Getting started, Contributing etc.
Only create subfolders when needed. Aim for a flat structure.
Last modified December 23, 2020: Change dolittle.io to docsy theme (3a7aed3)