Имеется приватный/частный репозиторий на GitHub. В папке решения (solution в Visual Studio), которое представляет репозиторий,имеется файл без расширения README, который "подхватывается" GitHub'ом для использования в качестве начальной страницы репозитория. На GitHub'e имеется Wiki, которая, согласно документации, может быть склонирована следующей командой
git clone https://github.com/USERNAME/REPOSITORY.wiki.git
Но в этом случае создаётся отдельный репозиторий. Получается, что код отдельно, Wiki отдельно. Отсюда возник вопрос:
каким образом использовать файлы Markdown, находящиеся непосредственно в папке решения, для Wiki GitHub'a?
На мой взгляд удобно видеть изменения файлов проекта из одного места, а не отдельных репозиториев. Может быть имеются какие-то общепринятые практики? Сейчас на ум приходит лишь добавление ссылок в README, которые вели бы на Markdown-файлы находящиеся в подпаке решения docs, но в этом случае весь функционал (оглавление, ссылки и т.д.) Wiki от GitHub'a отваливается.
Предвидя предложения использования сторонних сервисов генерации документации, обращу внимание на то, что репозиторий приватный/частный.