85bb7929fc | ||
---|---|---|
.github | ||
.husky | ||
docs | ||
src | ||
static/img | ||
.gitignore | ||
.prettierignore | ||
.prettierrc | ||
Jenkinsfile | ||
README.md | ||
babel.config.js | ||
docusaurus.config.js | ||
package.json | ||
tsconfig.json | ||
yarn.lock |
README.md
Description
This repository contains the content of your documentation website.
How to Run Locally
- Clone this repository.
- Install the dependencies:
$ yarn
- 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.
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.
Continuous Deloyment
master
branch is deployed to https://develp.co by CI
develop
branch is deployed to https://dev.develp.co by CI
Change Process
- Create a new working branch from
develop
:git checkout develop; git checkout -b my-changes
; - Proceed with changes, push to
origin
and open a Pull Request againstdevelop
; - Once approved, merge pull request, check changes on dev.develp.co;
- Once ready to promote to live website, rebase master on staging:
git checkout master; git pull master; git rebase origin/develop; git push
.