Thanks for considering contributing to the Aztec documentation site! This document contains a set of guidelines for contributing to the documentation. These are mostly guidelines, not rules. Use your best judgment, and feel free to propose changes to this document in a pull request.
All contributors and participants will follow the Code of Conduct.
This site is built using docusaurus. If you have questions
This repo is not for asking general questions, so don't open issues with questions.
If you have a question about Aztec, consult the live documentation site at https://docs.aztec.network, or join the Discord server and ask the community.
If you have a question about contributing to the docs, post in the Discussions tab.
This site is built using Docusaurus.
🧐 Docusaurus is a static-site generator. It builds a single-page application with fast client-side navigation, leveraging the full power of React to make your site interactive. It provides out-of-the-box documentation features but can be used to create any kind of site (personal website, product, blog, marketing landing pages, etc).
If you have questions about how Docusaurus works, consult their documentation before you contribute.
Write pages in markdown. Docusaurus reference.
When you create a new page, the file path must be added to ./sidebars.js for the page to be rendered on the site.
Markdown front matter should include a title at minimum.
---
title: Page title
---When adding images, update the page extension to be .mdx.
Import Ideal image to the page.
import Image from '@theme/IdealImage';Add the image with the path to the image in ./static/img/.
<Image img={require('/img/proofs-on-proofs.png')} />Things to note:
- If you want to modify anything related to the sidebar pages tree, modify
./sidebars.js. Consult these docs for reference. - The search on the Docusaurus documentation site is excellent. Try searching for the topic in question.
When in doubt, check existing sections of the code to see if there are relevant references.
Aztec's docs are structured in accordance to a few smart people's philosophies about documentation. You can read the guidelines into how we write docs here.
The following documents were referenced in the creation of this doc.