This repository is no longer being actively maintained with the retirement of the Community Plugin.
This website is built using Docusaurus 2, a modern static website generator. This is an awesome tool that allows you to build a documentation website with a free and open source codebase.
This project uses Node.js and that will need to be installed in order to contribute or run this project locally.
Additionally, you may want to install Yarn to manage your dependencies.
The main website is contained in a nested folder so to get started you will need to run the following command:
cd website
For NPM:
npm install
For Yarn:
yarn install
For NPM:
npm run dev
For yarn:
yarn dev
This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
For NPM:
npm run build
For Yarn:
yarn build
This command generates static content into the build directory and can be served using any static contents hosting service. The build folder will represent what is deployed as the website, however, your local environment may not create the same build that the deployment server will.
The site is deployed using GitHub pages. For more information on the deployment setup, please refer to the following guide
A global <underconstruction /> component has been created that can be used within markdown files to signify that the page is currently under construction. Add the component and additionally add the following Doc item metadata which will automatically be picked up by the autogenerated sidebar configuration:
At the top of your .md file:
--- sidebar_label: <your-label> 🚧 ---
The 🚧 emoji will be added to the sidebar label to signify more globally that documentation is still needed. Unfortunately this is currently a fairly manual process requiring clean-up after the documentation is completed.