Docs: Allow for a clean run of make check (#57)

docs/.markdownlint.json

@@ -0,0 +1,3 @@
+{
+    "MD013": { "line_length": 120 }
+}

docs/Makefile

@@ -10,9 +10,9 @@ dev:
 
 check:
 	docker run --rm \
-		-v ${PWD}:/usr/src/docs alcion/docs vale --glob='*.md' .
+		-v ${PWD}:/usr/src/docs alcion/docs vale --glob='docs/**/*.md' .
 	docker run --rm \
-		-v ${PWD}:/usr/src/docs alcion/docs markdownlint '**/*.md'
+		-v ${PWD}:/usr/src/docs alcion/docs markdownlint '**/*.md' --ignore styles/ --ignore src/
 
 shell:
 	docker run --rm -it \

docs/README.md

@@ -2,41 +2,41 @@
 
 Corso documentation is built using [Docusaurus 2](https://docusaurus.io/), a modern static website generator.
 
-### Installation
+## Installation
 
-```
+```bash
-$ make buildimage
+make buildimage
 ```
 
-### Live Docs
+## Live Docs
 
-```
+```bash
-$ make dev
+make dev
 ```
 
-This command starts a local development server within the Docker container and will expose docs at http://localhost:3000.
+This command starts a local development server within the Docker container and will expose docs at [http://localhost:3000](http://localhost:3000).
 
-### Build Docs
+## Build Docs
 
-```
+```bash
-$ make build
+make build
 ```
 
 This command generates static content into the `build` directory and can be served using any static contents hosting service.
 
-### Check Docs
+## Check Docs
 
-```
+```bash
-$ make check
+make check
 ```
 
 This command will lint all Markdown files and check them for style issues.
 
-### Documentation Platform Development
+## Documentation Platform Development
 
-
+```bash
-```
+make shell
-$ make shell
 ```
 
-This command is when you want to interactively (and temporarily!) change the contents or configuration of the live documentation container image.
+This command is when you want to interactively (and temporarily!) change the contents or
+configuration of the live documentation container image.

docs/docs/intro.md

@@ -8,7 +8,6 @@ Let's discover **Corso in less than 5 minutes**.
 
 ## Getting Started
 
-
 ### What you'll need
 
 - Docker

docs/docs/tutorial-basics/corso-repository-and-configuration.md

@@ -2,6 +2,6 @@
 sidebar_position: 1
 ---
 
-# Repositories and Configuration
+# Repositories and configuration
 
-How to configure Corso...
+How to configure Corso:

docs/styles/Vocab/Base/accept.txt

@@ -1,2 +1,3 @@
+Corso
 Docusaurus