|
|
rss_habr
DocOps на Flow 2022Четверг, 29 Декабря 2022 г. 21:40 (ссылка)
29-30 ноября прошла конференция для аналитиков FlowConf 2022. Основная особенность конференции — ее ориентация на конкретные практические рецепты. Одним из направлений, которое содержит много таких рецептов, стал Docs As Code или, в более широком смысле, DocOps в работе аналитика. В посте представляю обзор этого направления. Читать дальше →https://habr.com/ru/post/708338/?utm_source=habrahabr&utm_medium=rss&utm_campaign=708338
rss_habr
28 расширений VS Code для разработки документацииЧетверг, 10 Ноября 2022 г. 23:50 (ссылка)
Плагины Vs Code, без которых техническим писателям и разработчикам документации жить можно, но сложно. В подборке — линтеры, форматирование, работа с git, проектирование API, подготовка схем и милота для удобной разработки. Читать дальшеhttps://habr.com/ru/post/698702/?utm_source=habrahabr&utm_medium=rss&utm_campaign=698702
rss_habr
[recovery mode] Кровь, пот и слезы: как я переделал навигацию на сайте документации и в чём профит переделкиПонедельник, 17 Октября 2022 г. 16:04 (ссылка)
Привет! Меня зовут Владимир, но вы можете звать меня просто Иннокентий Алексеевич. Я люблю эксперименты. Сегодня я расскажу, как можно улучшить навигационное меню на сайте документации, сократить время сборки и размер сайта больше чем в два раза. В качестве примера возьму сайт документации, собранный при помощи Antora. Кому будет полезен материал: техническим писателям, разработчикам сайтов документации и просто любителям опенсорса и красивых вещей. Antora — генератор статических HTML сайтов из исходных AsciiDoc файлов. Antora бесплатная и имеет открытый исходный код. Читать дальше → https://habr.com/ru/post/693832/?utm_source=habrahabr&utm_medium=rss&utm_campaign=693832
rss_habr
Проект и тьма стейкхолдеров: как облегчить жизнь архитекторуПятница, 26 Августа 2022 г. 12:51 (ссылка)
Несколько раз мне приходилось выступать в роли архитектора на проектах по созданию информационных систем с большим количеством заинтересованных участников — стейкхолдеров. Могу сказать, работа эта не из лёгких: пока соберёшь под сотню необходимых виз — весь взмокнешь. В этом очерке хочу рассказать о подходах, которые, на мой взгляд, могут облегчить жизнь архитектору и команде проекта. Читать далееhttps://habr.com/ru/post/684788/?utm_source=habrahabr&utm_medium=rss&utm_campaign=684788
rss_habr
Как мы ведём документацию рядом с кодомВторник, 09 Августа 2022 г. 12:00 (ссылка)
В Альфа-Банке мы уже больше 5 лет ведём документацию рядом с кодом. Но она используется не для всех проектных документов. Дело в том, что документация у нас делится по слоям: фронт, миддл и бэкенд. Если с миддлом — слоем микросервисов — всё хорошо, то вот с переводом фронт- и бэк-документации в Bitbucket возникает трудность в необходимости хранения бинарников с примерами пользовательского интерфейса. В статье я опишу, как мы работаем с миддл-документацией, и поделюсь текущими наработками, а на примере документации по фронту обозначу существующие трудности и расскажу, какие варианты решения мы рассматриваем. Статья подойдёт техническим писателям, системным аналитика и всем, кто занимается подготовкой технической документации на программные продукты. Читать далееhttps://habr.com/ru/post/680556/?utm_source=habrahabr&utm_medium=rss&utm_campaign=680556
|
LiveInternet.Ru |
Ссылки: на главную|почта|знакомства|одноклассники|фото|открытки|тесты|чат О проекте: помощь|контакты|разместить рекламу|версия для pda |