DocOps

2022-08-31 14:41:49 Подкаст про DocOps для аналитиков сегодня в 16:00 Мск

Николай Поташников позвал меня поговорить про документацию и DocOps для аналитиков в подкаст Flow Live. Спикеры очень клёвые и разные, я даже не со всеми знаком, самому очень интересно. Эфир будет сегодня в 16 часов тут:



А пока что накидайте вопросов и тем, пожалуйста. Особенно если вы системный/бизнес/другой аналитик. Что вам интересно, про что хотите услышать, что у вас болит в документации? Открыть/Комментировать

2022-08-26 10:02:44 Обсуждали с коллегой, что мы резко повысили требования к описанию сделанной работы, а по истории коммитов видно, что раньше как попало делали.

— Мы как будто сегодня докапываемся до того, как держим вилку и нож, а вчера мы ели людей и это никого не беспокоило.

А что у вас в сообщениях коммитов и описаниях пулл-реквестов? Пишете как попало? Соблюдаете сотню правил и пишете многостраничные тексты? Что-то среднее? Расскажите :) Открыть/Комментировать

2022-08-25 09:57:07 Из менторской сессии. Бывают вот такие диалоги:
— Чувак у нас сарай горит!
— «Чувак» это обращение, после него нужна запятая! Открыть/Комментировать

2022-08-12 11:55:06 Писать в документации «мы» — довольно фиговая практика. Непонятно, кто это. Мы, которые писали код? Мы, которые писали доки? Мы с читателем (щас на пару тут пройдем туториал)?

Хуже этого только «мы» в логах и API. Вот прямо сейчас я смотрю на We are completely uploaded and fine, а после этого ответ 502. Нет, мы не fine, совсем не fine. Открыть/Комментировать

2022-07-19 09:01:17 «Не бывает задач, над которыми вредно думать» С утра пораньше пересматриваю доклад Фила Дельгядо про дизайн-ревью. Суть практики в том, чтобы перенести ревью пораньше к началу задачи: — Раньше обдумывали решение в процессе работы, а ревью делали на готовом… Открыть/Комментировать

2022-07-12 09:25:46 «Не бывает задач, над которыми вредно думать»

С утра пораньше пересматриваю доклад Фила Дельгядо про дизайн-ревью. Суть практики в том, чтобы перенести ревью пораньше к началу задачи:
— Раньше обдумывали решение в процессе работы, а ревью делали на готовом коде. А потом переделывали, потому что решение неверное.
— Теперь обдумываем дизайн решения, сразу ревьюим его, а потом пишем код. Меньше переделываем, больше радуемся.

Хорошая практика, рекомендую хотя бы познакомиться и обдумать. Тестировщики узнают в этом shift left. Для документации это точно так же применимо: можно обдумать место и структуру для будущей доки. В Тарантуле мы часть этой работы делаем в процессе триажа задачи.



Открыть/Комментировать

2022-07-06 11:47:07 Кто прод шатает по утрам,
Тот поступает мудро.
Тарам-парам-тарам-парам,
На то оно и утро!

Интересная у меня работа сейчас. В ней есть немного разработки, тестирования и DevOps. Документацию пишу регулярно, правда не для внешних пользователей, а для своих же. Большая часть работы про что-то вроде управления продуктом, где продукт — это платформа и инструменты для разработчиков. Есть планирование и декомпозиция задач. Есть дизайн-ревью технических решений. Наконец, есть работа с командой: цели, развитие, мотивация, вот эти все прекрасные штуки. Не работа, а мечта.

Ещё бы это всё не было так адски сложно. Прямо сейчас сложнее всего даётся планирование и декомпозиция больших задач, где не видно конца и края.

А в вашей работе что самое сложное? Открыть/Комментировать

2022-07-01 15:42:12 Комикс про зоопарк систем для управления личными знаниями от https://www.instagram.com/innubis/ прям в самое сердечко Открыть/Комментировать

2022-06-29 05:39:43 С утра нашёл прекрасное 1x.engineer Открыть/Комментировать

2022-06-01 14:15:09 Можно зарегистрироваться на бесплатный онлайн-день и послушать доклад Николая. Регистрация здесь: https://heisenbug.ru/registration/personal/ Открыть/Комментировать