Конечно! В группу выложу обязательно

Я. Но я не «обычный райтер», а технический копирайтер. Работал преимущественно с IT и техническими темами. Техрайтер «в процессе окукливания», как писали выше 🙂

#tw_wanted
Всем добрый день!
Компания ТЕКНО специализируется на финтех решениях с 2008 года. На данный момент ищет Технического писателя (https://hh.ru/vacancy/49438099). Удаленная работа, full time.
Для уточнения деталей пишите в телеграм: @svbykova

Как и обещал, делюсь ссылкой: https://habr.com/ru/post/589457/

У нас в компании была документация в DITA и маркдавн. Однажды мы решили обновить её, поручили мне заняться этим. Я думал, что да как, надумал, выбрал Antora + Asciidoc. Все шаги записал, чтобы поделиться, как я проводил исследования и к чему присматривался. Оформил всё в статью в двух частях - первая про поиски, вторую про настойку найденного. Первая часть уже готова, нужно только опубликовать, в понедельник опубликую, дам ссылку.

Спасибо, Владимир.

Буду благодарен за комменты и любые вопросы, если что-то не понятно.

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

если кратко, то нужен человек, который умеет писать простым языком и имеет опыт разработки различных документов: не только РП, но и руководство по развёртыванию, описание API и прочее.

работаем по большей части удалённо, документы ведём пока что в dokuwiki, в будущем можем пересесть в конфлюенс или внедрить единый источник. оформление по ТК.

есть ещё формальное описание вакансии на хедхантере.

если интересно — пишите в личные сообщения @mmaroo

#tw_wanted

Статья оставляет смешанное впечатление. По сути, Вам не хватило технических компетенций на использование DITA и Sphinx. С учётом этого, Ваш выбор продукта выглядит скорее последней соломинкой, чем осознанным выбором после взвешивания всех технических аспектов.

Ну и местами: «Windows при конвертации с использованием Pandoc чудит с кодировками так, что на выходе получается нечитаемое.» — да ладно? Образец в студию.

«Иронично, конечно, что сайт DITA Open Toolkit написан на Markdown.» — во-первых, https://github.com/dita-ot/website/tree/master/3.6 , а во-вторых — что за шпилька в адрес СПО? Открыто и бесплатно для Вас доступен мощнейший продукт, а Ваша претензия к разработчикам, которые делают своё дело бесплатно и в свободное время — в том, что они выбрали путь попроще, чтобы не писать ещё и сайтогенерацию на XSLT.

Вроде бы в этом и ирония. "Выбрали путь попроще и не стали использовать свой язык".

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

Коллеги, а подскажите, пожалуйста, следующий момент. Готовлю статьи в Markdown, в одном из аутлайнеров (ну что поделаешь, мне так удобнее). Потом что-то будет уезжать в конфлуенсу или еще куда.

Проблема такая - иногда в статьях должны фигурировать многоуровневые списки, при чем вида 1.2.3.х. Но насколько я знаю в md такое не реализовано вэ стандартном синтаксисе (вложенность там отображается только отступом и нумерацией с единицы до икс).

Что посоветуете? Я понимаю, инструмент нерелевантен задаче как минимум частично. Но что делать?

Если я изобрёл эсперанто, а сам продолжаю говорить на английском или испанском, мне трудно будет быстро найти сторонников эсперанто, сколь бы удобным он ни был.

Я что-то не помню, а в конфле можно кастомный css прикрутить?

Вот тоже хз

Если можно, то переопределите нумерацию вложенных списков

Может плагин есть который на каждую страницу будет делать инъекцию CSS? Там правда каждый чих платный

В целом, мысль понял. Спасибо. Чет не сообразил сам. :)