History

Knative Prow Robot 61dd77e715 update docker image (#4828 ) Co-authored-by: Dave Protasowski <dprotaso@gmail.com>		2022-03-15 14:55:59 -07:00
..
Dockerfile	update docker image (#4828 )	2022-03-15 14:55:59 -07:00
README.md	Grammar fix (#4455 )	2021-11-09 02:28:43 -08:00
build-image.sh	update docker image (#4828 )	2022-03-15 14:55:59 -07:00
run.sh	sync main with release-1.2 (#4772 )	2022-02-22 06:58:03 -08:00
test.sh	sync main with release-1.2 (#4772 )	2022-02-22 06:58:03 -08:00

Development notes for working with mkdocs

You can use a Docker container and run MkDocs from the container, so no local installation of mkdocs is required:

You need to have Docker installed and running on your system
There are helper configurations installed if you have npm from Node.JS installed.
Build the development docker container image, this is only need it once if the dependencies have not changed.
```
npm run dev:build
```
To start developing run the following command in the root directory of the git repo (where package.json and mkdocs.yaml are located)
```
npm run dev
```
Open a browser to http://localhost:8000, where you will see the documentation site. This will live update as you save changes to the Markdown files in the docs directory.
To stop developing run the following command in another terminal window, which will terminate the docker container
```
npm run dev:stop
```
To build the static HTML files including both mkdocs and hugo run the following command.
```
npm test
```
To view additional npm scripts run the following command
```
npm run
```