*проверяет три раза в разных прогах* 😅

Спасибо, как раз нужна хорошая практика. Думаю это лучший курс, который можно найти

"Подход Docs-as-Code это очень плохо. У вас будет куча проблем. Я всеми силами отговариваю вас работать с документацией как с кодом. Но раз уж вы упёрлись, и настаиваете, то я скажу вам как решить все проблемы связянные с Docs-as-Code. Их решит один инструмент. Уникальный. Другого такого нет. И по счастливой случайности этот инструмент делаем мы."

--

Немножко напрягает, что инструмент всего один на свете. Завтра они закроются, и что тогда? Стоило бы привести альтернативы.

А так, до того как дочитал до продающей части, думал, мужик продвигает вики.

У любого инструмента есть проблемы. Попытки закрыть одними серебряными граблями все нужды обычно заканчивается предсказуемо. Плюс, все исследования рекомендуют использовать тот инструмент, который уже используется в компании. Если вы, конечно, не CKO и не можете оценить затраты на внедрение нового и продавить его

Если инструмент требует прикладывать усилий больше, чем экономит, значит, на данном уровне организационной зрелости он вам просто не подходит

Ни в коей мере не хочу сказать, что подход DAC плох. Но надо трезво понимать выгоду от системного подхода в этом вопросе. Сможете ли вы получить профит? Или перегруженный техпис, у которого и так когнитивная нагрузка зашкаливает, станет ещё одним посредственным пользователем Гита?

От того, что раньше доки лежали в Вики, а теперь в репе, их качество не улучшится.

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

Вот у тебя хорошая, адекватная критика. А в этой статье критика уровня "если земля — шар, почему вся вода ещё не стекла вниз?".

Спасибо!

Тебе спасибо! Я согласен, от смены инструмента качество контента не вырастет.

А что за "все исследования", можешь дать ссылки?

Увы, я сейчас не вспомню из головы. Я, когда политики и метрики для КМ формулировал у себя, пропустил через голову 100500 white papers на эту тему. И минимум в 3 разных видел - "не пытайтесь пересадить людей на новый инструмент в масштабах компании, они все равно будут использовать то, что используют"

Нуу, большинство претензий мне кажутся надуманными

Автор предвзято относится к DAC чтобы продвигать свой продукт. 👍

ох, спасибо всем за отзывы, это было невероятно приятно:)

собственно, да, осталось последнее место на курс Advanced Technical Writing 27-28 сентября в Москве, http://documentat.io/courses/advanced-techwriting-moscow/

Улыбнул пассаж про VS Code: However, when you’re using “docs like code” and editors like VS Code to write the documents, what is this process going to look like? The tools that come with technical editors are more geared towards software engineers, i.e. they’re probably geekier and more cumbersome :)

Мде :)

индус индусу рознь. С которыми я работал (и даже нанимал на работу)) был хороший грамотный английский (письменный). Местами с British flavor, что логично. Вот про их устный англ. — это другая песня, конечно...

привет. есть ли разница между changelog и release notes?