У нашего главного редактора пропал нюх, но не пропал нюх на хо | Technical Writing 101 🇺🇦

У нашего главного редактора пропал нюх, но не пропал нюх на хорошие статьи про документацию! *badum tss* (уже все хорошо, смотрите картинку к посту)

Сегодня статья о важности Organizational Memory, о позльзе шаблонов и о пересмотре отношения к организации документации. Товарищи из Nebo признали, что чистый Agile подход к документированию (“You should only create a document if it fulfills a clear, important and immediate goal of your overall project efforts.”) эт не совсем то, что их устраивает. Было принято решение организовать группу быстрого реагирования “Great Document-Palozza” и пеерсмотреть свой подход к хранению и накоплению инженерной документации.

Спрыгнув с Agile подхода к документированию, было решено пользоватся напутствием Том Томпсона, цитируя его статью “Why agile teams should care about documentation”: “When the engineers and writers collaborate in an iterative process, they can learn from each other and make the whole process more efficient…[Moreover,] Getting technical writers involved early is a great way to get feedback on your design. If your documentation team can't figure out a feature, your customers probably won't either.” (эту статейку тоже читните, слегка базовыве вещи говорит, но, “Повторение – мать учения”!)

Получилось у них или нет — читайте в полной версии статьи How I Learned to Stop Worrying and Love Engineering Documentation

Не болейте, это скучно