a5ad6e6788
## Description This reworks CI now that we have merged docs and website into a single deployment. ## Type of change <!--- Please check the type of change your PR introduces: ---> - [ ] 🌻 Feature - [ ] 🐛 Bugfix - [ ] 🗺️ Documentation - [ ] 🤖 Test - [x] 💻 CI/Deployment - [ ] 🐹 Trivial/Minor ## Issue(s) <!-- Can reference multiple issues. Use one of the following "magic words" - "closes, fixes" to auto-close the Github issue. --> * Fixes https://github.com/alcionai/corso/issues/1551 ## Test Plan <!-- How will this be tested prior to merging.--> - [x] 💪 Manual - [ ] ⚡ Unit test - [ ] 💚 E2E
72 lines
1.7 KiB
Markdown
72 lines
1.7 KiB
Markdown
# Corso documentation
|
|
|
|
Corso documentation uses [Docusaurus 2](https://docusaurus.io/), a modern static website generator.
|
|
[Mermaid](https://mermaid-js.github.io/mermaid/) provides support for native diagrams in Markdown.
|
|
|
|
## Requirements
|
|
|
|
Developing documentation for Corso requires the following tools on your machine:
|
|
|
|
- `make`
|
|
- Docker
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
make buildimage
|
|
```
|
|
|
|
## Live documentation development
|
|
|
|
```bash
|
|
make dev
|
|
```
|
|
|
|
This command starts a local development server within the Docker container and will expose docs at [http://localhost:3000](http://localhost:3000).
|
|
|
|
## Generating Corso CLI docs
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
make build
|
|
```
|
|
|
|
This command generates static content into the `build` directory for integration with any static contents hosting service.
|
|
|
|
## Serving static documentation
|
|
|
|
```bash
|
|
make serve
|
|
```
|
|
|
|
This command will serve the static content generated with `make build` at [http://localhost:3000](http://localhost:3000).
|
|
|
|
## Style and linting
|
|
|
|
```bash
|
|
# Lint all docs
|
|
make check
|
|
# Lint specific files and/or folders
|
|
make check VALE_TARGET="README.md docs/concepts"
|
|
```
|
|
|
|
This command will lint all Markdown files and check them for style issues using the Docker container
|
|
|
|
## Documentation platform development
|
|
|
|
```bash
|
|
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).
|