• Description
• How to Run Locally
• Configuration
• Customization

Description

This repository contains the content of your documentation website.

How to Run Locally

1. Clone this repository.
2. Install the dependencies:

$ yarn

3. Start and open the website in your browser:

$ yarn start

Configuration

Edit the docusaurus.config.js file in the repository's root directory, and update the value of the businessUnit field in presets section; below is a list of valid values:

• Logos
• Codex
• Waku

Example:

presets: [
  [
    '@acid-info/logos-docusaurus-preset',
    {
      businessUnit: 'Codex',
    },
  ],
],

This is probably enough in most cases, as the Logos plugins will fill in other configurations related to the specified business unit. If you find any error in the information coming from Logos Plugins, please head over to Logos Docusaurus Plugins and create an issue.

CI/CD

• CI builds master and pushes to deploy-master branch, which is hosted at https://codex.storage//.
• CI builds develop and pushes to deploy-develop branch, which is hosted at https://dev-docs.codex.storage//.

The hosting is done using Caddy server with Git plugin for handling GitHub webhooks.

Information about deployed build can be also found in /build.json available on the website.

Customization

You can find the instructions on adding more documentation sections, localization, and versioning on the Docusaurus website.

Note that theme customization is limited; for further instructions on customizing your theme, head over to Logos Docusaurus Theme.