Size: a a a

DocOps-сообщество

2019 July 31

FM

Fox Mulder in DocOps-сообщество
Anna Ryutina
сейчас джун это не только кодеры, это еще и просто лингвисты, которые тупо пишут доки в прогах (например H&M, Madcap)
Извините, я запутался. Тоесть у вас джун техпис пишет доки, ещё он лингвист, а ещё он и кодер ?
источник

AR

Anna Ryutina in DocOps-сообщество
Fox Mulder
Извините, я запутался. Тоесть у вас джун техпис пишет доки, ещё он лингвист, а ещё он и кодер ?
он вообще может не быть кодером) эти проги помогают писать не меняя код
источник

KC

Kseniya Chudakova in DocOps-сообщество
Проливаю слёзки над этим списком, хочется везде побывать https://telegra.ph/Konferencii-dlya-tehpisov-osen-07-31
источник

L

Lex in DocOps-сообщество
Fox Mulder
Дарья, тогда я не понимаю. Есть джун техпис, он может самостоятельно разобрать код, выдернуть оттуда куски и написать пример какой либо функции. Чем же тогда у вас занимается мидл техпис?
Тем же самым, только еще влияет на продукт, может предложить переделать апишечку на другую и т. д
источник

H

Hartmann in DocOps-сообщество
Fox Mulder
Я свечку не держал, да и не люблю я это, но в jb все отлично. Мне говорили, что оттуда не выгонешь никого.
Не понял о свечке.
Я высказал предположение. Раз говорили — хорошо.
источник

СФ

Семён Факторович in DocOps-сообщество
Fox Mulder
Семён, я немного не про это. А то, что daac как процесс практически не имеет покрытия и подавляющая часть организации документирования основана на ворд, как инструмент, и ГОСТ в качестве методологии
ок, но тогда ваши рассуждения выглядят как «сейчас бензиновых машин в разы больше, чем электрических, поэтому нет никакого смысла становиться специалистом в электромоторах и аккумуляторах»
источник

L

Lana in DocOps-сообщество
Fox Mulder
Интересно, а как это было организовано? Как то я даже не могу представить
вот на последнем митапе как раз кейс такой был гост+заказня разработка доков + docs as code, таргет-то можно любой настроить, если постараться
источник

L

Lex in DocOps-сообщество
Fox Mulder
Получается как в jetbrains где техпис по сути полноценный разработчик.
Если писать доку для разработчиков, то техпис - разработчик тоже. Пусть не самый продвинутый, но пример кода состряпать может
источник

СФ

Семён Факторович in DocOps-сообщество
Семён Факторович
ок, но тогда ваши рассуждения выглядят как «сейчас бензиновых машин в разы больше, чем электрических, поэтому нет никакого смысла становиться специалистом в электромоторах и аккумуляторах»
есть текущая ситуация, а есть ее производная
источник

L

Lana in DocOps-сообщество
вот да, особенно на API, ну и на WTD само собой
источник

FM

Fox Mulder in DocOps-сообщество
Lana
вот на последнем митапе как раз кейс такой был гост+заказня разработка доков + docs as code, таргет-то можно любой настроить, если постараться
Лана, каюсь, не смотрел, очень много работы. Но мне казалось, что daac это не только инструменты, но и процесс. Не понимаю, как заставить всех участников создания продукта исповедовать daac
источник

L

Lana in DocOps-сообщество
Fox Mulder
Лана, каюсь, не смотрел, очень много работы. Но мне казалось, что daac это не только инструменты, но и процесс. Не понимаю, как заставить всех участников создания продукта исповедовать daac
советую посмотреть тогда хотя бы одно выступление, третье по счету
источник

AY

Andrei Yemelianov in DocOps-сообщество
Anna Ryutina
сейчас джун это не только кодеры, это еще и просто лингвисты, которые тупо пишут доки в прогах (например H&M, Madcap)
а что за компания? (можно в личку)
источник

AY

Andrei Yemelianov in DocOps-сообщество
Fox Mulder
Интересно, а как это было организовано? Как то я даже не могу представить
на Гитхабе видел шаблоны документов по ГОСТу
пишут в  md, из которого потом верстают PDF и docx
источник

FM

Fox Mulder in DocOps-сообщество
Anna Ryutina
он вообще может не быть кодером) эти проги помогают писать не меняя код
Аааа, ну тогда я тоже разработчик, ведь я с самим Radu из oxygenxml баги правил))
источник

AR

Anna Ryutina in DocOps-сообщество
=))
источник

FM

Fox Mulder in DocOps-сообщество
Andrei Yemelianov
на Гитхабе видел шаблоны документов по ГОСТу
пишут в  md, из которого потом верстают PDF и docx
Я делал шаблоны в docbook для ГОСТ, но при этом, не считаю что исповедовал daac. Тоесть процесс создания документации и кода не был прозрачен. Использование только одного инструмента, отличного от ворда, не даёт право называться daac. Имхо.
источник

D

Daria in DocOps-сообщество
Fox Mulder
Дарья, тогда я не понимаю. Есть джун техпис, он может самостоятельно разобрать код, выдернуть оттуда куски и написать пример какой либо функции. Чем же тогда у вас занимается мидл техпис?
у нас очень много всего.
джуну дают, например, отдельную фичу, которую он описывает целиком (подробное описание API занимает достаточно времени)
миддл находится уже на уровне целых контролов
ну и так далее. чем выше уровень, тем шире и глубже знание продукта и тем больше ответственности
источник

FM

Fox Mulder in DocOps-сообщество
Дарья, а не приводит у вас это к тому, что мидл техпис уходит в чистую разработку и начинает получать уже как мидл разработчик?
источник

D

Daria in DocOps-сообщество
Fox Mulder
Дарья, а не приводит у вас это к тому, что мидл техпис уходит в чистую разработку и начинает получать уже как мидл разработчик?
некоторые уходят в разработку, но вот например барышня, которая у меня ментором, занимается  тут доками уже много лет
не всем интересна чистая разработка, кто-то осознанно хочет писать доки (например я)
источник