Size: a a a

2019 July 25

KC

Kseniya Chudakova in technicalwriters
Nick Volynkin
Разные ветки в git
это ок, но как при этом реализовать переключатель на сайте?
источник

R

Roht in technicalwriters
в нашей конторе это вопрос не моего ума, но вообще у нас просто собираются разные билды в тим сити с несколькими версиями документации
источник

R

Roht in technicalwriters
+ к сайту прикручен скрипт, который подставляет путь в зависимости от выбранной пользователем версии
источник

R

Roht in technicalwriters
но это все homebrew-решения
источник

NV

Nick Volynkin in technicalwriters
Kseniya Chudakova
это ок, но как при этом реализовать переключатель на сайте?
А, это работа фронтендера
источник

KC

Kseniya Chudakova in technicalwriters
Roht
в нашей конторе это вопрос не моего ума, но вообще у нас просто собираются разные билды в тим сити с несколькими версиями документации
спасибо!
источник

KC

Kseniya Chudakova in technicalwriters
Nick Volynkin
А, это работа фронтендера
у меня пока что исследовательский интерес) потом с фронтами будем решать, да
источник

A

Angela in technicalwriters
Kseniya Chudakova
у меня пока что исследовательский интерес) потом с фронтами будем решать, да
у вас какой формат/движок? у нас sphinx-doc/rst и тоже стоит аналогичная задача на фронт
источник

A

Angela in technicalwriters
мы вплотную подошли к поддержке как минимум двух релизов, и надо реализовывать версионность справочной системы
источник

NV

Nick Volynkin in technicalwriters
В целом так:
Разные ветки git для разных версий, из них собираются разные версии доки. Каждая падает в свою папку на сервере, оттуда их nginx показывает пользователям.
На каждую страницу при сборке врезается выпадающий список или переключатель, в котором выделена текущая версия и есть другие.
Переключение по языкам — такой же список.
источник

R

Roht in technicalwriters
Nick Volynkin
В целом так:
Разные ветки git для разных версий, из них собираются разные версии доки. Каждая падает в свою папку на сервере, оттуда их nginx показывает пользователям.
На каждую страницу при сборке врезается выпадающий список или переключатель, в котором выделена текущая версия и есть другие.
Переключение по языкам — такой же список.
собственно, примерно аналогично все это и выглядит у нас
источник

A

Angela in technicalwriters
Nick Volynkin
В целом так:
Разные ветки git для разных версий, из них собираются разные версии доки. Каждая падает в свою папку на сервере, оттуда их nginx показывает пользователям.
На каждую страницу при сборке врезается выпадающий список или переключатель, в котором выделена текущая версия и есть другие.
Переключение по языкам — такой же список.
это всё понятно) стоит вопрос, каким образом это всё реализовать
источник

R

Roht in technicalwriters
собирать в отдельные ветки, выкладывать на прод, подставлять урлы скриптом, за визуалом к фронт-энду
источник

R

Roht in technicalwriters
вопрос в том, что придется поддерживать пресловутые отдельные ветки в актуальном состоянии (например, если разрабатываются клауд- и стэндэлон-версии), но быстрее что-то ничего не придумывается
источник

A

Angela in technicalwriters
Roht
собирать в отдельные ветки, выкладывать на прод, подставлять урлы скриптом, за визуалом к фронт-энду
пока идея фризить релизы в бранчах от мастера и подкладывать ссылки под реализацию списка версий, у нас справка собирается в докерах в дженкинсе и выкладывается на сервер, тут ещё девопсов привлекать надо
источник

R

Roht in technicalwriters
кстати, если поддерживать всего две версии (и сильно больше в планах нет), можно табы использовать
источник

R

Roht in technicalwriters
источник

ET

Eduard Tibet in technicalwriters
Kseniya Chudakova
это ок, но как при этом реализовать переключатель на сайте?
В зависимости от существующих знаний на местах. Самое простое - простейший баш-скрипт и копирование веток куда-то для кормления nginx. Самое сложное - непосредственный доступ к репо через libgit или jgit, если все это крутится внутри томката и компании.
источник

R

Roht in technicalwriters
у нас это сделано магией xsl-конвертации
источник

KC

Kseniya Chudakova in technicalwriters
Eduard Tibet
В зависимости от существующих знаний на местах. Самое простое - простейший баш-скрипт и копирование веток куда-то для кормления nginx. Самое сложное - непосредственный доступ к репо через libgit или jgit, если все это крутится внутри томката и компании.
спасибо!
источник