Skip to main content

Improve Wiki

Follow this guide if you want to add documentation in Archcraft Wiki...

Prerequisite

  • Setup the local development environment, If you want to work locally.
  • You should have the basic understanding of the syntax of Markdown and MDX. See Docusaurus Markdown Features.
  • You, at least know how to fork, clone a repository and create a pull request.

Files and format

The docs directory has subdirectories (to categories documentations) which contains the .md and .mdx files for each wiki post and a _category_.json file for docs category.

  • The _category_.json file is used to label and position (on sidebar) the category.
  • Here's the example of Boot Archcraft section of our wiki
docs                          # Main Directory
└── boot-iso # Doc Category
├── _category_.json # Category Properties
├── boot-with-usb.mdx # Wiki Page
└── boot-with-grub.mdx # Another wiki page in same category

Front matter

In front matter, You can specify the position of doc in category, etc.

---
sidebar_position: 1
hide_table_of_contents: true
---

For more info, visit Docusaurus:Docs