Forums / National / Russian / Идеи / Github интеграция.

По поводу доков на ГХ. Вот какая нескладуха вырисовывается —

у нас есть определнная структура документации (разделы, подразделы), у нас есть несколько языков, англияский вроде главный (т.к. ориентируемся на широкий массы и т.к. там инфы больше).

Теперь допустим я хочу добавить статью (например) в русскую документацию (расширить), или просто дополнить раздел (описанием послених изменений). Как быть? Как и кто будет мониторить связность структуры промеж языков и полноту перевода (если статья была расширена)? 

Идеи решения:

1. придерживаться идеи, что английская версия главная и ее структура будет основной для ее транслирования по отдельным языкам.
2. Взять за правило всем тем, кто будет следить за репозиторием (и правила эти расписать), что если в одной из национальных док идет изменение (дополнение статьи или структуры), то их надо (хотя бы на уровне изменения структуры и упоминания пропусков) отметить в английской версии. Остальные нац. версии — поддерживаются закрепленными для этого лицами самостоятельно на основе англ. версии.
3. Для удобства контроля изменений и необходимости правок статей разделов — использовать гитхабовские тикеты (issues).
4. Думаю будет удобнее завести на Гите «организацию» в рамках нее сделать по отдельному репозиторию для каждого язака (на которые можно по отдельности давать доступ менеджерам). Таким образом не будет каши из разноязычных тикетов в одном репо. 

Еще на гитхабе есть такая штука как Wiki. Не знаю применимо ли оно к нашим задачам, но ссылку приведу:

https://github.com/blog/699-making-github-more-open-git-backed-wikis