Откуда такие сложности с wiki - ponyatov/nimbook GitHub Wiki

Откуда такие сложности с wiki

GitHub предоставляет доступ к wiki проекта через git, но не включает поддержку всего механизма с pull request, GitHub форками, выгрузкой wiki в различных форматах, и т.п. При создании форка проекта не создаётся форк wiki.

Для удобного редактирования wiki предпочтительнее интерфейс github, и использование браузера -- wiki является рабочей копией, каталог /wiki в проекте требуется для сравнения, pullrequestов, и генерации /docs/.html

В итоге, приходится включать в основной проект средства зеркалирования wiki, и скрипты получения различных производных форматов документации через пакет pandoc и фильр-скрипты. pandoc имеет неадекватно ограниченную поддержку разметки github markdown, поэтому приходится писать развесистые фильтры. В будущем есть возможность написать собственный полнофункциональный [процессор документации markdown]] -> html,epub,... на Nim, или даже [базу знаний, но пока пришлось обойтись Python.