Я первым делом советую этот тг-канал

А я про него спрашиваю на собеседовании )) Приятно, когда кандидат знает про этот канал

Согласна

Быстрый заказ (работа).  #wanted_tw

Ищу человека знающего oxygen xml + dita.

Сделать, чтобы выходной документ в pdf соответствовал изначальному word (который проходит через вывод oxygen) так как  разметка не так отображается как в изначальном доке, а именно:
- центрировать изображения с подписью
- задать конкретный шрифт
- сделать пробелы, чтобы разделы стояли ровно, как стоят в ворде.

Пишите мне в личку, док отправлю. Оплата сразу.

Коллеги, продолжаю поиски нового инструмента для написания мануалов. Углубилась в изучение идеи Docs as code и возник вопрос, насколько нам такой подход поможет, если код разработчиками вообще не документируется? Говорят, такой необходимости нет сейчас.
Всю информацию они передают устно техписателю.

и даже комментарии в коде не пишут?

а как онбордятся новые погромисты?

неожиданный бонус того, что документация лежит рядом с кодом - разработчики ОЧЕНЬ внимательно читают то, что кладёт в их репу техписатель) всегда куча комментариев

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

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

да, не общаться не получится)

это безусловно плюс! да!

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

если затягивают, задаю наводящие вопросы в чятике

устно 🙈 + комментарии в коде. А вообще каждый новый человек к компании проходит некий этап изучения того, чем вообще компания занимается. А там уже погружается код, параллельно работая в течение некоторого времени со старшим разработчиком

если новичков не много, может и норм

у вас разработчики тоже заинтересованы в наличии документации к коду, как и техрайтер? У нас два процесса идут независимо, увы. Хочу обосновать им необходимость подхода  Документации как код, а не представить так, как будто им нужно будет дополнительную работу проделывать.

немного, поэтому и не заморачиваются. За последний год 2 разработчика, до этого несколько лет не менялся состав

это не вы им должны обосновать, а их начальник) иначе это будет борьба с ветряными мельницами

Я прослушала вебинары от Ducumentat, вдохновилась! Писать как раньше уже не хочу!