Skip to main content

Sidebars

Updated Mar 12, 2025 ·

Overview

The sidebar is the menu on the left side. It can be auto-generated, or manually defined in the sidebar.js. It is recommended to have it automatically generated.

Naming of folders

When renaming or adding sidebars, make sure to rename both the folder as well as the label in _category_.json file. the folder name and label name does not need to match.

Naming of files

Similar with folders, the filenames does not need to match the actual titles of the files. The title of the markdown file can be written with the "#" to signify the title heading, or use the title in the Frontmatter (see section below).

Changing the ordering

In your IDE, folder names will appear in alphabetical order. However, we can change their order when rendered by specifying their position in the _category_.json file. In the example above, the folder "Microsoft Azure" appears as the fourth folder inside the docs. But since we specified its position as 9th, it will be displayed in a different order in the browser.

Ordering of the Sidebars

NOTE

The ordering will be updated from time to time so it might not match the sample photo above.

These are the current ordering:

OrderSidebar
00Technical Notes
01Personal Notes
02IT Foundations
03Linux
04Networking
05Cybersecurity
06Cloud Computing
07Amazon Web Services
08Microsoft Azure
09Google Cloud
15Containerization
16Insfrastructure as Code
17Version Control and CICD
18Observability
19DevSecOps
20Site Reliability Engineering
21Project Management