Отличный разбор того, как в Google, Twitter и Spotify подходят к развитию культуры написания документации. Обязательно почитайте про контекст каждой из компаний, а я просто пошарю несколько идей, которые мне понравились.
📌Чем меньше когнитивной нагрузки требуется, чтобы начать писать документацию для нового проекта, тем больше вероятность, что ее напишут – поэтому стоит стандартизировать подходы и инструменты, а также держать документацию близко к коду.
📌Познакомить больше разработчиков с практикой написания документации и научиться хорошим практикам помогают DocDays – короткие хакатоны.
📌Строгие процессы не помогают, гораздо лучше инвестировать в тулинг и культуру.
Post #682
4.27K