Кто тут Симонов?

Формализовали плюсы и минусы трёх основных подходов к документированию на проектах.

Мы тут проводим митап от программного комитета KnowledgeConf. В первой половине записали плюсы и минусы разных подходов к документации и тому, как сохранять знания о проекте.

Часть 1. Документация в головах
+ Передавать из уст в уста — это быстро.
+ Информация максимально актуальная
+ Быстрая обратная связь
+ Выкатили новую фичу — сразу есть документация
+ Не пишем доку, экономим деньги бизнеса
+ Развиваем soft skills
+ Люди эмоционально вовлечены
+ Много лайфхаков и багофич, которые не запишешь в документацию
+ Высокая информационная неуязвимость. Никто не сольёт доку, потому что её нет.
+ Высокий уровень доверия, потому что все решения хранятся в головах.
- Не фиксируем договоренности
- Всё в голове не удержишь
- Непосильный труд — донести мысль одинаково для всех
- Не отслеживается версионность
- Неравномерность знаний
- Больше времени занимает онбординг
- Онбординг отвлекает знающих экспертов
- Знания уходят с ключевыми сотрудниками
- Информация искажается при передаче
- Утечки времени на получение знаний на каждом этапе разработки
- Ограничение времени к информации. Ночью не у кого спросить.
- Сложно работать с распределёнными интернациональными комнадами.
- Сложно масштабировать проект.
- Непрозрачность со стороны для аудита, консультирования, помощи
- Культивирует точки экспертизы, которые могут покинуть проект
- Затрудняет повторяемость положительного результата.

Полный конспект тут: https://github.com/NickVolynkin/teamleadconf-19/blob/master/source/km-meetup.md

Формализовали плюсы и минусы трёх основных подходов к документированию на проектах.

Мы тут проводим митап от программного комитета KnowledgeConf. В первой половине записали плюсы и минусы разных подходов к документации и тому, как сохранять знания о проекте.

Часть 2. Долго готовим документацию, потом пишем код
+ Сохранность
+ Доступность
+ Версионность
+ Ускоряем интеграцию со внешними командами, поставщиками и т.п.
+ Культурный бонус: всех приучили писать доку
+ Устанавливаем общую терминологию
+ Уменьшаем ошибки проектирования, потому что пока пишем, всё продумываем на несколько раз
+ Нетехнические люди могут читать документацию, если она написана человеческим языком
+ Иммунитет к автобусному фактору
+ Разработка быстрее, как от TDD
+ Проще отдавать проект заказчику
+ Проще внедрять
- Дорого по деньгам и времени
- Документация устаревает
- Читать всю доку дольше, чем задать один вопрос эксперту
- Удлиняет релиз, все ждут документацию
- Скучно писать документацию
- Документацию можно потерять! Человек ушёл и забрал все свои файлы.
- Не надо писать красивый и понятный код, потому что документация же всё объяснит
- У разработчика нет свободы выбирать технические решения
- Заказчик вносит коррективы. Если дока не меняется — продукт не попадёт в настоящие требования.
- Если документация и код разделены, появляется расхождение.

Полный конспект тут: https://github.com/NickVolynkin/teamleadconf-19/blob/master/source/km-meetup.md

Формализовали плюсы и минусы трёх основных подходов к документированию на проектах.

Мы тут проводим митап от программного комитета KnowledgeConf. В первой половине записали плюсы и минусы разных подходов к документации и тому, как сохранять знания о проекте.

Часть 3. Самодокументируемый код
+ Документация всегда актуальна
+ Автоматизируется, доставляется в CI/CD
+ Ограничен круг редакторов
+ Мотивирует хорошо писать код
+ Не бывает избыточной
+ Легко передавать
+ Версионность
+ Можно получить обзор архитектуры проекта
+ Пишется сразу вместе с кодом
- Нельзя положить графику и даже схемы в код
- Сложно поддерживать. Как юнит-тесты. Постоянно нужно следить за актуальностью артефактов.
- Ограничения по пост-редактированию. Не можем приставить к каждому программисту техрайтера, который будет редактировать текст.
- Ограничен круг редакторов.
- Разработчик должен уметь писать хороший код и комментарии. Такой разработчик дороже.
- Нельзя так написать проектную документацию: требования, постановку задачи.
- Бизнес-логику очень сложно документировать в коде.
- Давать всем доступ к коду может быть проблематично

Полный конспект тут: https://github.com/NickVolynkin/teamleadconf-19/blob/master/source/km-meetup.md

Обсудить за документацию и документирование тут: https://t.me/ctorecordschat

Те, кто выбирают "другое" пишите сразу, plz, что именно вот тут: https://t.me/ctorecordschat

** На правах рекламы **

Ребята из GetIT проводят митапы для разработчиков в сотрудничестве с крупными компаниями на тему того, как улучшить код, прокачать софт скиллы и найти работу в крутых компаниях в России и за рубежом.
Выступать будут как разработчики, так и HR. 1 марта состоится митап в МегаФон.

Спикеры и темы митапа:
- Как оценивать софт скилы при найме людей в команду — Евгений Сугробов, Banki.ru
- Как выстроить работу с удаленной командой — Дарья Афанасьева, Skyeng
- Тим-лид как Заказчик, как строить работу с HR и давать фидбеки по подбору специалистов в команду — Светлана Стаканова и Мария Трофимова, МегаФон
- Зачем разработчику персональный бренд — Антон Пальгунов и Юлия Великанова, Банк Revolut
- Как тим-лиду выстроить эффективную коммуникацию в команде — Виталий Шароватов, Ex Head of Front-end Badoo.

Регистрация:
https://www.getitcommunity.com/

Обсудить за митап тут: t.me/ctorecordschat

Производительность труда в России остается на уровне, который в развитых странах был достигнут в 1980-х годах, то есть 30–40 лет назад. Об этом заявил глава Счетной палаты Алексей Кудрин, выступая на открывшемся в Санкт-Петербурге Международном форуме труда.

«Выработка на одного работающего у нас примерно $23 в час. Даже в Турции уже в 1,5 раза больше, у американцев примерно в три раза больше. Мы пока находимся где-то на уровне 80-х годов стран «Большой семерки», — сказал Кудрин, слова которого приводятся в сообщении пресс-службы Форума труда.

https://www.rbc.ru/society/28/02/2019/5c780f559a7947ca09226ad3

Кто подскажет, а что это за производительность труда? Все ж пашут от зари до зари. Как её повышать?

Напишите вот тут, пожалуйста: https://t.me/ctorecordschat

Андрея @Secretgram не стало :(

Сегодня скончался Андрей Юдин. Это страшное горе для всех нас. Прощание с Андреем состоится в понедельник, 4 марта. Место и время мы сообщим позже. Страшная потеря….Вечная память яркому, жизнерадостному человеку, с невероятной энергией... По всем вопросам помощи семье пишите дочери Андрея Анне Юдиной
https://m.facebook.com/story.php?story_fbid=10217114733873331&id=1018648209

Павел Тычина: Очень редко встречаются статьи обязательные для прочтения и это одна из таких статей (особенно полезно прочесть сторонникам автаркии, дирижистских методов в экономике и тому подобного).

Более того, огромные карты технологического развития страны должны висеть в кабинетах всех федеральных чиновников (в том числе и силовых, может быть даже в первую очередь).

Карты технологического развития региона должны висеть в кабинетах региональных чиновников и депутатов.

Все должны быть озабочены ростом технологий, изображенных на этих картах. Работу всех ветвей власти следует оценивать по тому насколько быстро увеличивается плотность точек на этой карте.

Сравните технологическое развитие Турции, Польши и России.

http://carnegie.ru/commentary/2016/02/26/ru-62888/iuij

Обсудить за технологии здесь: t.me/ctorecordschat

Умирает 1С-ник во сне и предстает перед райскими воротами.
— Что случилось? Где я?
Святой, перелистывая книгу, отвечает:
— Видите ли, милейший, вы умерли.
— Да быть не может! — прерывает 1С-ник, — Я такой молодой, к доктору недавно ходил на обследование и все было отлично.
— А мы просто подсчитали все отработанные часы, за которые вы выставили счета клиентам и оказалось, что вам уже 88 лет.

Обсудить за разработку на 1с тут: t.me/ctorecordschat

Техдирский канал теперь и в твиттере: https://twitter.com/ctorecords

Комон!

Август 2013, планируем adcamp.ru, appintop.com, adcel.co!