History

Fix docs dev build when dependencies are not installed (#915 )

Make sure dependencies are properly installed before building

<!-- Insert PR description-->

## Type of change

<!--- Please check the type of change your PR introduces: --->
- [ ] 🌻 Feature
- [x] 🐛 Bugfix
- [ ] 🗺️ Documentation
- [ ] 🤖 Test
- [ ] 💻 CI/Deployment
- [ ] 🐹 Trivial/Minor

## Issue(s)

## Test Plan

<!-- How will this be tested prior to merging.-->
- [x] 💪 Manual
- [ ] ⚡ Unit test
- [ ] 💚 E2E

2022-09-20 19:06:38 +00:00

docs

Docs Auto-Generation (#803 )

2022-09-09 14:38:58 +00:00

src

Adds docusorus-plugin-sass plugin and enhances the existing theme (#786 )

2022-09-06 23:33:23 +00:00

static

Docs structure and initial content (#658 )

2022-08-26 20:45:50 -07:00

styles

Some quality of life docs tooling improvements (#664 )

2022-08-26 19:03:36 -07:00

.gitignore

Remove sample docs (#56 )

2022-05-19 13:32:03 -07:00

.markdownlint.json

Docs structure and initial content (#658 )

2022-08-26 20:45:50 -07:00

.vale.ini

Some quality of life docs tooling improvements (#664 )

2022-08-26 19:03:36 -07:00

babel.config.js

Add docs template (#40 )

2022-05-16 22:44:49 -07:00

Dockerfile

Docs upgrades (#596 )

2022-08-19 16:15:14 +00:00

docusaurus.config.js

Adds docusorus-plugin-sass plugin and enhances the existing theme (#786 )

2022-09-06 23:33:23 +00:00

Makefile

Fix docs dev build when dependencies are not installed (#915 )

2022-09-20 19:06:38 +00:00

package-lock.json

Adds docusorus-plugin-sass plugin and enhances the existing theme (#786 )

2022-09-06 23:33:23 +00:00

package.json

Adds docusorus-plugin-sass plugin and enhances the existing theme (#786 )

2022-09-06 23:33:23 +00:00

README.md

Auto-generate CLI docs in docs dev tooling (#721 )

2022-09-01 18:50:09 +00:00

sidebars.js

Missing env command in docs sidebar (#715 )

2022-08-31 23:40:29 +00:00

README.md

Corso documentation

Corso documentation uses Docusaurus 2, a modern static website generator. Mermaid provides support for native diagrams in Markdown.

Requirements

Developing documentation for Corso requires the following tools on your machine:

make
Docker

Installation

make buildimage

Live documentation development

make dev

This command starts a local development server within the Docker container and will expose docs at http://localhost:3000.

Generating Corso CLI docs

make genclidocs

Corso's CLI documents are auto-generated. This command explicitly triggers generating these docs. This step will happen automatically for the other commands where this is relevant.

Building static documentation

make build

This command generates static content into the build directory for integration with any static contents hosting service.

Style and linting

# Lint all docs
make dockercheck
# Lint specific files and/or folders
make dockercheck VALE_TARGET="README.md docs/concepts"

This command will lint all Markdown files and check them for style issues using the Docker container

make check

Same as make dockercheck but runs locally. Requires vale to be installed.

Documentation platform development

make shell

Use this command to interactively (and temporarily!) change the contents or configuration of the live documentation container image (for example, when experimenting with new plugins).