Еще раз про HUGO! Он обманчив прост. Если брать только тему и не модифицировать её, то да, hugo зайдет.
Но! Вот далее, потребуется не просто начальные, а прямо так advanced скиллы в css+js+toml+yaml+html.
Многие вещи не решаются вот просто так, а требуют глубокого погружения в фронтенд. Ну или отдать кастомизацию фронту, но не всегда это возможно.

Станислав, если ты хочешь кастомизировать тему или написать свою, то конечно же тебе понадобятся хоть базовые навыки. Но опять же, готовых тем полно, курсов по фронтенду тоже полно )

ну ты не пугай ежа голой жопой, у нас и так кастомная тема и фронтендеров найдем если что. просто хотелось бы с минимальным количеством усилий запустить

Кто прост и без обмана?

MD наверное лучше хранить в git'е, а в Confluence лишь публиковать результат. Благо Confluence сам преобразует MD во внутреннюю разметку.

https://marketplace.atlassian.com/apps/1211675/git-for-confluence

https://community.atlassian.com/t5/Confluence-questions/How-to-import-hundreds-of-md-files/qaq-p/725975

Если честно, претензия у меня серьезная только одна - их сайт с докой падает постоянно.

я и говорю, у меня больше возникло вопросов по управлению всем этим потенциальным git-хозяйством. Вот предположим несколько веток в git - каждая ветка будет для отдельной версии одного продукта, вот как отслеживать какой файл в одной ветке соответствует (описывает один и тот же объект) файлу описания другой ветки? Как можно оперативно отслеживать изменения (допустим разрабы внесли, как в этом ворохе можно быстро увидеть, что они внесли - что фактически требует правка). и немаловажно - что из этого всего "было переведено, а что только требует перевода".

тут напрашивается, еще какие-то внешние инструменты для управления содержимым этого самого гита

Хе! Неприятно, но Cloudflare поможет им.

#wanted_tw #техническийписатель #technicalwriter #relocate #Кипр
Всем привет! Мы продолжаем искать в нашу продуктовую команду на Кипре Технического писателя.
Мы международная хостинговая компания, оперируем на протяжении 10 лет на рынках США, Западной и Восточной Европы и Азии. ​Мы строим полностью автоматизированную платформу, способную удовлетворять разнообразным требованиям наших клиентов.

Чем предстоит заниматься:
- создание и поддержание в актуальном состоянии базы знаний по продуктам и технологиям на английском языке;
- текстовое и схематическое описание сложных технических решений;
- организация и активное участие в процессе разработки документации продуктов.

Требования:
- опыт работы в качестве технического писателя от 1 года;
- грамотная устная и письменная речь, умение кратко выражать свои (и чужие) мысли;
- технический английский;
- умение работать с Atlassian Confluence и JIRA;
- высшее образование (желательно, техническое).

Будет плюсом:
- опыт работы в хостинговых компаниях;
- понимание принципов работы сетей;
- опыт в области разработки ПО;
- знание UML (и желание его использовать).

Мы предлагаем:
- достойную оплату и медицинскую страховку;
- организацию процесса получения рабочей визы и виз для семьи;
- официальное оформление;
- интересные задачи и возможность для развития компетенций;
- солнечную атмосферу, теплый климат, обеды в офисе.

Присоединяйтесь к нашей команде! Буду благодарна за резюме tatyana@servers.com

Вы имеете в виду Atlassian SourceTree?
https://www.sourcetreeapp.com/

Добрый день. Татьяна, добавьте, пожалуйста, тэг, как указано в прикреплённом наверху сообщении. Спасибо.

вот если честно. не уверена. у нас был настроен конкретный рабочий процесс с отслеживанием всех необходимых изменений. сейчас разрабы решили, что новый продукт они будут писать в по-другому (и формаТ, и хранение), но конкретных инструментов (под установленный процесс) пока не предлагали. что я от них слышала - это Git + Visual Studio Code. Но это не то, что я могу назвать инструментом для конкретной задачи в уже установленном процессе

У нас если что-то в каком-нибудь PR изменилось, на почту падает письмо. Так что мимо изменений особо не пройдёшь.
В рамках PR изменения отслеживаются по diff.
В том репозитории, где мы работаем совместно с программистами, нельзя мержить PR, пока техписатель не согласует правки, так что мимо нас всё равно не пройти.
С переводами да, может быть проблема.

Проверку работоспособности ссылок вроде можно настроить (но это отдельный инструмент).

Изменения вы будете видеть автоматом после checkout'а.

Или так: https://stackoverflow.com/questions/10641361/get-all-files-that-have-been-modified-in-git-branch/10641810

Попросите разработчиков показать вам основные приёмы работы с гитом.

Если есть ресурсы, то можно в ci куда-нибудь засунуть типа скриптика, проверяющего изменения. Мы все хотим такой, но ресурса нет пока 😔

Попросите разработчиков добавить уведомления, например через BitBucket.

https://confluence.atlassian.com/bitbucketserver/repository-notifications-949754838.html

Docusaurus :)

интересно. Спасибо!