У меня документация, что хранится в гите - это MD "с описанием встроенного языка программы". Продукт свежий, вышла только бета, файлы хранятся по структуре объектов (задают разработчики, я не влияю). С одной стороны мне легче, с другой стороны, действительно интересно, что будет, если они решат что-то перенести (пока есть пара версий в разработке, но там не было такого). Но и эти MD уходят в контекстную подсказку проги и на сайт в виде HTML с оглавлением. И на сайте редиректы таки снова будет хранить группа поддержки.
Впрочем, например, для другой доки мы храним идентификаторы разделов (привязаны к заголовками) , что позволяет нам менять структуру разделов , практически не ломая ссылки. Так и живём.