Size: a a a

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

2018 December 25

SK

Sergei Kutcher in DocOps-сообщество
Нет, не так
источник

FM

Fox Mulder in DocOps-сообщество
Anastasia Prokopyeva
Как бы плясать нужно от печки: от потребностей и целей. У нас все читают конфлюенс, никого не надо заставлять.
У нас очень часто непонятно, что является валидной информацией, а что нет. Без прямого запроса необойтись
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Anastasia Prokopyeva
Задавать вопросы разрабам придется, потому что как реализовано знают только они. Либо просто научиться читать код
Для чего может понадобиться знать про внутреннее устройство тому, кто даже прочитать код не может?
источник

AP

Anastasia Prokopyeva in DocOps-сообщество
Поддерживать актуальность надо, офк (сложная штука). Тут ещё приоритеты важны. Не обязательно поддерживать все актуально. Некоторые доки в прочитку никогда не пойдут
источник

AP

Anastasia Prokopyeva in DocOps-сообщество
Vadim Smelyanskiy
Для чего может понадобиться знать про внутреннее устройство тому, кто даже прочитать код не может?
При взаимодействии между командами. У нас аналитики одной команды часто задают вопросы аналитикам другой команды, потому что так проще строить иерархию в общении.
источник

SK

Sergei Kutcher in DocOps-сообщество
Я не так выразился - вопросы должны поступать в соотвествии с иерархией - пока сервис и команда были "маленькие" отсутствовала "вторая линия ТП". Вопросы стекались в ТП, а оттуда по мере знаний сотрудников ТП - они решались сразу или вопрос задавался разрабам. Но, сервис растет, растет и команда. Цена человекочаса разработчика так-же растет.
источник

FM

Fox Mulder in DocOps-сообщество
Anastasia Prokopyeva
Поддерживать актуальность надо, офк (сложная штука). Тут ещё приоритеты важны. Не обязательно поддерживать все актуально. Некоторые доки в прочитку никогда не пойдут
А если (возвращаясь выше) ЭМ, которые непосредственно отвечаеют за достоверность информации и ее актуальность, данным вопросам не занимаются ))
источник

AP

Anastasia Prokopyeva in DocOps-сообщество
+ не мочь читать код и не хотеть разные вещи. Я считаю, что если человек в айти, то он скорее НЕ ХОЧЕТ читать код
источник

FM

Fox Mulder in DocOps-сообщество
Anastasia Prokopyeva
+ не мочь читать код и не хотеть разные вещи. Я считаю, что если человек в айти, то он скорее НЕ ХОЧЕТ читать код
А если ему платят 60к?
источник

AP

Anastasia Prokopyeva in DocOps-сообщество
Мне платят меньше 60к и?
источник

FM

Fox Mulder in DocOps-сообщество
Или даже так. Где та зарплата, при которой технический писатель начинает читать код , оставаясь ТП
источник

FM

Fox Mulder in DocOps-сообщество
Anastasia Prokopyeva
Мне платят меньше 60к и?
Это ужасно
источник

AP

Anastasia Prokopyeva in DocOps-сообщество
Этот вопрос не ко мне.
Я пришла на БА и меня посадили модель обучать. На ирисах правда, но это было больно. Но теперь зато я знаю, что люди просто НЕ ХОТЯТ читать код. Вот таки мое имхо
источник

SK

Sergei Kutcher in DocOps-сообщество
Эмм, где тот уровень, когда тех.пис перестает читать код и становиться джуном/мидлом. Ибо, как мне кажеться, в пищевой цепочке писатель занимает не лучшее место
источник

AP

Anastasia Prokopyeva in DocOps-сообщество
Тут вопрос желания. Мне абсолютно комфортно не писать код. Всё
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Anastasia Prokopyeva
При взаимодействии между командами. У нас аналитики одной команды часто задают вопросы аналитикам другой команды, потому что так проще строить иерархию в общении.
От себя добавлю ещё

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

Например, приняли GDPR :)
"Господа разрабы, а что мы реально храним о пользователе?"
источник

FM

Fox Mulder in DocOps-сообщество
Anastasia Prokopyeva
Этот вопрос не ко мне.
Я пришла на БА и меня посадили модель обучать. На ирисах правда, но это было больно. Но теперь зато я знаю, что люди просто НЕ ХОТЯТ читать код. Вот таки мое имхо
Условно я ТП, я получаю 50к. Я пишу документацию. Где моя мотивация бесплатно, для бизнеса читать код? Вот для роста да, я не только буду читать код, но и писать его.
источник

FM

Fox Mulder in DocOps-сообщество
Sergei Kutcher
Эмм, где тот уровень, когда тех.пис перестает читать код и становиться джуном/мидлом. Ибо, как мне кажеться, в пищевой цепочке писатель занимает не лучшее место
Именно! Я как ТП, научившись кодить, уйду на разработчика. Например, в JetBrains ТП не только писатель, но и разработчик. Но и получает он не 50 и не 100к
источник

СФ

Семён Факторович in DocOps-сообщество
> Например, в JetBrains ТП не только писатель, но и разработчик

так ли?
источник

L

Lana in DocOps-сообщество
Fox Mulder
Условно я ТП, я получаю 50к. Я пишу документацию. Где моя мотивация бесплатно, для бизнеса читать код? Вот для роста да, я не только буду читать код, но и писать его.
Не понимаю как писать доки, не читаю код, у нас это входное условие, мы документируем архитектуру и api, библиотеки классы, но конечно и вилка начинается от в два раза выше
источник