Современное оформление для документации

Doks - это шаблон для статического генератора Hugo. С его помощью можно создавать безопасные и быстрые сайты с документацией, оптимизированные под SEO. Doks использует npm для управления зависимостями. Автор темы - Хенк Верлинде.

Опыт перевода

С чем придется столкнуться при переводе документации?

Critical:

title нужен в config.toml, а не params.toml
для дерева нужны файлы все *.ru.md, даже не переведенные, иначе сайт не построится

Possible enhancements:

в теме пока нет переключателя языков, вы получите версию на адресе .../ru/ (причем /ru без слеша в конце будет ошибкой)
приглашение поиска Algolia пока не говорит по-русски

Not language-related:

пробелы в заголовках пункте menu испортят весь праздник
на разных уровнях верхняя менюшка
лучше если тест на первой странице будет шире - секчас загоняет заголовок

С чего начать?

поизучать папку config/_default
посмотреть папку content

Чего там сложного?

зачем помимо config/_default еще и другие папки?
структура параметров разбросана по разным файлам
именно в этой теме есть дублиование и неиспользуемые параметры
есть, или были, два варианта разбрасывания переводов - по файлам или по папкам

Куда еще посмотреть?