Что происходит?

Для примеров кода в примерах используется mdoc:
в папке docs лежат Markdown-файлы, которые затем "компилируются" Mdoc-ом и попадают в папку kaska-docs/target/mdoc.

C помощью Github-Pages рендерится файл README.md, в котором прописаны ссылки до скомпилированных файлов с информацией.

Как с этим удобно работать?

Для работы необходимо иметь SBT и — если хочется написать код для библиотеки — редактор кода или IDE для Scala.
Также понадобится способ смотреть отрендеренные локально Markdown файлы так, чтобы превью еще автоматически обновлялось при изменении файла на диске. Я использую для этого Markdown Viewer.

Что делать?