Documentation

API Documentation (Scala)

We use scaladoc to generate our API documentation. To generate API documentaion use the following command:

sbt doc

This will generate HTML pages documenting the Scala API under target/scala-2.12/api/.

Note

These files are copied to the docs/api/odinson-rest directory when the command sbt documentize is used.

General Documentation

We use mkdocs to generate our site documentation from markdown. Markdown source files are located under the docs directory. To develop the documentation with live updates use the following command:

docker run --rm -it -v $PWD:/app \
    -p 8000:8000 \
    parsertongue/mkdocs:latest \
    mkdocs serve -a 0.0.0.0:8000

Open your browser to localhost:8000.