#документация_проекта — Public Fediverse posts

Всё есть код, или зачем внедрять GitOps в разработку

Привет, Хабр! Сегодня мы часто говорим про разные тренды в разработке — ИИ-агентов, тестирование на ранних стадиях, прослеживаемость изменений, автоматизацию пайплайнов… Все эти тренды звучат убедительно, пока не упираются в реальность: требования лежат в на общих дисках, схемы — в картинках, контракты — в разных версиях, а история изменений размазана по инструментам. Что делать с этим? Лев Немировский, руководитель направления по развитию инструментов внедрения ПСБ, рассказал, чем полезен в этом случае подход GitOps и о том, как и в каких случаях это может упростить жизнь команде.

https://habr.com/ru/companies/psb/articles/1038876/

#ci_cd #ci_cd_пайплайны #gitops #gitopsпрактики #документация #документация_проекта

Всё есть код, или зачем внедрять GitOps в разработку

Привет, Хабр! Сегодня мы часто говорим про разные тренды в разработке — ИИ-агентов, тестирование на ранних стадиях, прослеживаемость изменений, автоматизацию пайплайнов… Все эти тренды звучат убедительно, пока не упираются в реальность: требования лежат в на общих дисках, схемы — в картинках, контракты — в разных версиях, а история изменений размазана по инструментам. Что делать с этим? Лев Немировский, руководитель направления по развитию инструментов внедрения ПСБ, рассказал, чем полезен в этом случае подход GitOps и о том, как и в каких случаях это может упростить жизнь команде.

https://habr.com/ru/companies/psb/articles/1038876/

#ci_cd #ci_cd_пайплайны #gitops #gitopsпрактики #документация #документация_проекта

Всё есть код, или зачем внедрять GitOps в разработку

Привет, Хабр! Сегодня мы часто говорим про разные тренды в разработке — ИИ-агентов, тестирование на ранних стадиях, прослеживаемость изменений, автоматизацию пайплайнов… Все эти тренды звучат убедительно, пока не упираются в реальность: требования лежат в на общих дисках, схемы — в картинках, контракты — в разных версиях, а история изменений размазана по инструментам. Что делать с этим? Лев Немировский, руководитель направления по развитию инструментов внедрения ПСБ, рассказал, чем полезен в этом случае подход GitOps и о том, как и в каких случаях это может упростить жизнь команде.

https://habr.com/ru/companies/psb/articles/1038876/

#ci_cd #ci_cd_пайплайны #gitops #gitopsпрактики #документация #документация_проекта

Всё есть код, или зачем внедрять GitOps в разработку

Привет, Хабр! Сегодня мы часто говорим про разные тренды в разработке — ИИ-агентов, тестирование на ранних стадиях, прослеживаемость изменений, автоматизацию пайплайнов… Все эти тренды звучат убедительно, пока не упираются в реальность: требования лежат в на общих дисках, схемы — в картинках, контракты — в разных версиях, а история изменений размазана по инструментам. Что делать с этим? Лев Немировский, руководитель направления по развитию инструментов внедрения ПСБ, рассказал, чем полезен в этом случае подход GitOps и о том, как и в каких случаях это может упростить жизнь команде.

https://habr.com/ru/companies/psb/articles/1038876/

#ci_cd #ci_cd_пайплайны #gitops #gitopsпрактики #документация #документация_проекта

Как мы сделали автогенерацию документации для CI/CD из комментариев в коде

Привет, Хабр! Меня зовут Николай Чурянин, я занимаюсь iOS-разработкой в ПСБ. Сегодня я хочу рассказать вам, как делал новую документацию для нашего модуля CI/CD. Конечно же, документация у нас была и раньше. И даже не одна — а это, как понимаете, только усугубляло проблему. Часть документации лежала в readme-репозитории — с него-то она по сути и началась. Но обновлялась она там нерегулярно, оказалось, что работать с ней было не очень-то удобно. В какой-то момент этот репозиторий перестали поддерживать, и я попытался оформить её на внутреннем портале. Увы, пользы от этого стало ещё меньше: там документация была оторвана от кода — от наших скриптов. Вдобавок, её было трудно обновлять. Надо ли говорить, что и её забросили? «Совсем без документации тоже нельзя», — решил я и принялся искать другой способ. И нашёл его (спойлер: без ИИ тут не обошлось). Покажу, что получилось и как всё теперь работает.

https://habr.com/ru/companies/psb/articles/1032854/

#ci_cd #документация #документация_проекта #документация_это_легко #ии #ии_и_машинное_обучение

Как мы сделали автогенерацию документации для CI/CD из комментариев в коде

Привет, Хабр! Меня зовут Николай Чурянин, я занимаюсь iOS-разработкой в ПСБ. Сегодня я хочу рассказать вам, как делал новую документацию для нашего модуля CI/CD. Конечно же, документация у нас была и раньше. И даже не одна — а это, как понимаете, только усугубляло проблему. Часть документации лежала в readme-репозитории — с него-то она по сути и началась. Но обновлялась она там нерегулярно, оказалось, что работать с ней было не очень-то удобно. В какой-то момент этот репозиторий перестали поддерживать, и я попытался оформить её на внутреннем портале. Увы, пользы от этого стало ещё меньше: там документация была оторвана от кода — от наших скриптов. Вдобавок, её было трудно обновлять. Надо ли говорить, что и её забросили? «Совсем без документации тоже нельзя», — решил я и принялся искать другой способ. И нашёл его (спойлер: без ИИ тут не обошлось). Покажу, что получилось и как всё теперь работает.

https://habr.com/ru/companies/psb/articles/1032854/

#ci_cd #документация #документация_проекта #документация_это_легко #ии #ии_и_машинное_обучение

Как мы сделали автогенерацию документации для CI/CD из комментариев в коде

Привет, Хабр! Меня зовут Николай Чурянин, я занимаюсь iOS-разработкой в ПСБ. Сегодня я хочу рассказать вам, как делал новую документацию для нашего модуля CI/CD. Конечно же, документация у нас была и раньше. И даже не одна — а это, как понимаете, только усугубляло проблему. Часть документации лежала в readme-репозитории — с него-то она по сути и началась. Но обновлялась она там нерегулярно, оказалось, что работать с ней было не очень-то удобно. В какой-то момент этот репозиторий перестали поддерживать, и я попытался оформить её на внутреннем портале. Увы, пользы от этого стало ещё меньше: там документация была оторвана от кода — от наших скриптов. Вдобавок, её было трудно обновлять. Надо ли говорить, что и её забросили? «Совсем без документации тоже нельзя», — решил я и принялся искать другой способ. И нашёл его (спойлер: без ИИ тут не обошлось). Покажу, что получилось и как всё теперь работает.

https://habr.com/ru/companies/psb/articles/1032854/

#ci_cd #документация #документация_проекта #документация_это_легко #ии #ии_и_машинное_обучение

Как мы сделали автогенерацию документации для CI/CD из комментариев в коде

Привет, Хабр! Меня зовут Николай Чурянин, я занимаюсь iOS-разработкой в ПСБ. Сегодня я хочу рассказать вам, как делал новую документацию для нашего модуля CI/CD. Конечно же, документация у нас была и раньше. И даже не одна — а это, как понимаете, только усугубляло проблему. Часть документации лежала в readme-репозитории — с него-то она по сути и началась. Но обновлялась она там нерегулярно, оказалось, что работать с ней было не очень-то удобно. В какой-то момент этот репозиторий перестали поддерживать, и я попытался оформить её на внутреннем портале. Увы, пользы от этого стало ещё меньше: там документация была оторвана от кода — от наших скриптов. Вдобавок, её было трудно обновлять. Надо ли говорить, что и её забросили? «Совсем без документации тоже нельзя», — решил я и принялся искать другой способ. И нашёл его (спойлер: без ИИ тут не обошлось). Покажу, что получилось и как всё теперь работает.

https://habr.com/ru/companies/psb/articles/1032854/

#ci_cd #документация #документация_проекта #документация_это_легко #ии #ии_и_машинное_обучение

Нужен ли синопсис технической документации? Личный опыт разработки

Разработка документации на создаваемые ИТ-продукты – это не только «правила хорошего тона», но и насущная необходимость. Ведь без технического задания невозможно зафиксировать требования к продукту, без руководства пользователя сложно грамотно продуктом пользоваться, без технической документации, описывающей продукт, сложно будет искать и исправлять ошибки и проводить необходимые доработки, когда в них возникнет необходимость, и т.д. Обычно документацию делают по одному из двух путей – либо используют стандарты, описывающие требования к составу, структуре и содержанию документов (например, ГОСТ 19-й и 34-й серий – ЕСПД и КСАС), либо самостоятельно разрабатывают документ, создавая его на основе собственного опыта или по существующим образцам, в т.ч. взятых из интернета. Но как же её правильно сделать? Мой ответ - начинать надо с синопсиса документов.

https://habr.com/ru/articles/1015118/

#Синопсис #документация #документирование #документация_проекта #разработка_документации #техническая_документация #технический_писатель #техническое_задание

Нужен ли синопсис технической документации? Личный опыт разработки

Разработка документации на создаваемые ИТ-продукты – это не только «правила хорошего тона», но и насущная необходимость. Ведь без технического задания невозможно зафиксировать требования к продукту, без руководства пользователя сложно грамотно продуктом пользоваться, без технической документации, описывающей продукт, сложно будет искать и исправлять ошибки и проводить необходимые доработки, когда в них возникнет необходимость, и т.д. Обычно документацию делают по одному из двух путей – либо используют стандарты, описывающие требования к составу, структуре и содержанию документов (например, ГОСТ 19-й и 34-й серий – ЕСПД и КСАС), либо самостоятельно разрабатывают документ, создавая его на основе собственного опыта или по существующим образцам, в т.ч. взятых из интернета. Но как же её правильно сделать? Мой ответ - начинать надо с синопсиса документов.

https://habr.com/ru/articles/1015118/

#Синопсис #документация #документирование #документация_проекта #разработка_документации #техническая_документация #технический_писатель #техническое_задание

Нужен ли синопсис технической документации? Личный опыт разработки

Разработка документации на создаваемые ИТ-продукты – это не только «правила хорошего тона», но и насущная необходимость. Ведь без технического задания невозможно зафиксировать требования к продукту, без руководства пользователя сложно грамотно продуктом пользоваться, без технической документации, описывающей продукт, сложно будет искать и исправлять ошибки и проводить необходимые доработки, когда в них возникнет необходимость, и т.д. Обычно документацию делают по одному из двух путей – либо используют стандарты, описывающие требования к составу, структуре и содержанию документов (например, ГОСТ 19-й и 34-й серий – ЕСПД и КСАС), либо самостоятельно разрабатывают документ, создавая его на основе собственного опыта или по существующим образцам, в т.ч. взятых из интернета. Но как же её правильно сделать? Мой ответ - начинать надо с синопсиса документов.

https://habr.com/ru/articles/1015118/

#Синопсис #документация #документирование #документация_проекта #разработка_документации #техническая_документация #технический_писатель #техническое_задание

Нужен ли синопсис технической документации? Личный опыт разработки

Разработка документации на создаваемые ИТ-продукты – это не только «правила хорошего тона», но и насущная необходимость. Ведь без технического задания невозможно зафиксировать требования к продукту, без руководства пользователя сложно грамотно продуктом пользоваться, без технической документации, описывающей продукт, сложно будет искать и исправлять ошибки и проводить необходимые доработки, когда в них возникнет необходимость, и т.д. Обычно документацию делают по одному из двух путей – либо используют стандарты, описывающие требования к составу, структуре и содержанию документов (например, ГОСТ 19-й и 34-й серий – ЕСПД и КСАС), либо самостоятельно разрабатывают документ, создавая его на основе собственного опыта или по существующим образцам, в т.ч. взятых из интернета. Но как же её правильно сделать? Мой ответ - начинать надо с синопсиса документов.

https://habr.com/ru/articles/1015118/

#Синопсис #документация #документирование #документация_проекта #разработка_документации #техническая_документация #технический_писатель #техническое_задание

Как мы написали 46K строк на Claude Code и не сошли с ума: практический гайд

Vibe coding — это одновременно и мем, и реальность 2025-2026 года. Кто-то называет это будущим разработки. Другие считают, что это способ генерировать технический долг со скоростью света. Мы решили попробовать создать коммерческий проект с нуля полностью с помощью вайбкодинга. В результате: 46 000 строк кода, полтора месяца, два человека. Проект работает, клиент пользуется. Вообще как бы нифига себе – написать рабочую CRM, которая автоматизирует обработку входящих запросов и может автоматически работать по сделкам: отвечать на письма, ставить задачи, проводить сделку по воронке.

https://habr.com/ru/articles/1012106/

#Claude #vibe_coding #автоматизация_разработки #AIассистенты #NextJS #документация_проекта #AI_в_разработке

Как мы написали 46K строк на Claude Code и не сошли с ума: практический гайд

Vibe coding — это одновременно и мем, и реальность 2025-2026 года. Кто-то называет это будущим разработки. Другие считают, что это способ генерировать технический долг со скоростью света. Мы решили попробовать создать коммерческий проект с нуля полностью с помощью вайбкодинга. В результате: 46 000 строк кода, полтора месяца, два человека. Проект работает, клиент пользуется. Вообще как бы нифига себе – написать рабочую CRM, которая автоматизирует обработку входящих запросов и может автоматически работать по сделкам: отвечать на письма, ставить задачи, проводить сделку по воронке.

https://habr.com/ru/articles/1012106/

#Claude #vibe_coding #автоматизация_разработки #AIассистенты #NextJS #документация_проекта #AI_в_разработке

Как мы написали 46K строк на Claude Code и не сошли с ума: практический гайд

Vibe coding — это одновременно и мем, и реальность 2025-2026 года. Кто-то называет это будущим разработки. Другие считают, что это способ генерировать технический долг со скоростью света. Мы решили попробовать создать коммерческий проект с нуля полностью с помощью вайбкодинга. В результате: 46 000 строк кода, полтора месяца, два человека. Проект работает, клиент пользуется. Вообще как бы нифига себе – написать рабочую CRM, которая автоматизирует обработку входящих запросов и может автоматически работать по сделкам: отвечать на письма, ставить задачи, проводить сделку по воронке.

https://habr.com/ru/articles/1012106/

#Claude #vibe_coding #автоматизация_разработки #AIассистенты #NextJS #документация_проекта #AI_в_разработке

Как мы написали 46K строк на Claude Code и не сошли с ума: практический гайд

Vibe coding — это одновременно и мем, и реальность 2025-2026 года. Кто-то называет это будущим разработки. Другие считают, что это способ генерировать технический долг со скоростью света. Мы решили попробовать создать коммерческий проект с нуля полностью с помощью вайбкодинга. В результате: 46 000 строк кода, полтора месяца, два человека. Проект работает, клиент пользуется. Вообще как бы нифига себе – написать рабочую CRM, которая автоматизирует обработку входящих запросов и может автоматически работать по сделкам: отвечать на письма, ставить задачи, проводить сделку по воронке.

https://habr.com/ru/articles/1012106/

#Claude #vibe_coding #автоматизация_разработки #AIассистенты #NextJS #документация_проекта #AI_в_разработке

Где вести базу знаний: 8 российских сервисов и их возможности

Когда в команде больше 5 человек, ссылка на папку с документами перестает работать. Ну, или как минимум становится просто неэффективной. Файлы дублируются, версии путаются, половина инструкций устаревает. Поэтому мне захотелось посмотреть и разобрать российские сервисы для базы знаний — с ценами, ограничениями и честными плюсами/минусами. Подробнее о них — в статье ниже.

https://habr.com/ru/companies/kaiten/articles/984344/

#kaiten #база_знаний #документация #управление_проектами #управление_знаниями #заметки #документы #документация_проекта

Где вести базу знаний: 8 российских сервисов и их возможности

Когда в команде больше 5 человек, ссылка на папку с документами перестает работать. Ну, или как минимум становится просто неэффективной. Файлы дублируются, версии путаются, половина инструкций устаревает. Поэтому мне захотелось посмотреть и разобрать российские сервисы для базы знаний — с ценами, ограничениями и честными плюсами/минусами. Подробнее о них — в статье ниже.

https://habr.com/ru/companies/kaiten/articles/984344/

#kaiten #база_знаний #документация #управление_проектами #управление_знаниями #заметки #документы #документация_проекта

Где вести базу знаний: 8 российских сервисов и их возможности

Когда в команде больше 5 человек, ссылка на папку с документами перестает работать. Ну, или как минимум становится просто неэффективной. Файлы дублируются, версии путаются, половина инструкций устаревает. Поэтому мне захотелось посмотреть и разобрать российские сервисы для базы знаний — с ценами, ограничениями и честными плюсами/минусами. Подробнее о них — в статье ниже.

https://habr.com/ru/companies/kaiten/articles/984344/

#kaiten #база_знаний #документация #управление_проектами #управление_знаниями #заметки #документы #документация_проекта

Где вести базу знаний: 8 российских сервисов и их возможности

Когда в команде больше 5 человек, ссылка на папку с документами перестает работать. Ну, или как минимум становится просто неэффективной. Файлы дублируются, версии путаются, половина инструкций устаревает. Поэтому мне захотелось посмотреть и разобрать российские сервисы для базы знаний — с ценами, ограничениями и честными плюсами/минусами. Подробнее о них — в статье ниже.

https://habr.com/ru/companies/kaiten/articles/984344/

#kaiten #база_знаний #документация #управление_проектами #управление_знаниями #заметки #документы #документация_проекта

Корпоративная база знаний: как компании организовать хранение всех документов

Когда в компании нет порядка с внутренними материалами, нужная информация постоянно оказывается не там, где ее ищут. Из-за этого документы дублируются, никто не обновляет инструкции, а новые сотрудники дольше вникают в процессы. Чтобы этого не произошло, компании прибегают к созданию корпоративной базы знаний. Как легко систематизировать накопленные знания и как с этим может помочь Kaiten — в статье.

https://habr.com/ru/companies/kaiten/articles/979832/

#база_знаний #kaiten #документация #документация_проекта #проект #управление_проектами #знания_организации #хранение_информации

Корпоративная база знаний: как компании организовать хранение всех документов

Когда в компании нет порядка с внутренними материалами, нужная информация постоянно оказывается не там, где ее ищут. Из-за этого документы дублируются, никто не обновляет инструкции, а новые сотрудники дольше вникают в процессы. Чтобы этого не произошло, компании прибегают к созданию корпоративной базы знаний. Как легко систематизировать накопленные знания и как с этим может помочь Kaiten — в статье.

https://habr.com/ru/companies/kaiten/articles/979832/

#база_знаний #kaiten #документация #документация_проекта #проект #управление_проектами #знания_организации #хранение_информации

Корпоративная база знаний: как компании организовать хранение всех документов

Когда в компании нет порядка с внутренними материалами, нужная информация постоянно оказывается не там, где ее ищут. Из-за этого документы дублируются, никто не обновляет инструкции, а новые сотрудники дольше вникают в процессы. Чтобы этого не произошло, компании прибегают к созданию корпоративной базы знаний. Как легко систематизировать накопленные знания и как с этим может помочь Kaiten — в статье.

https://habr.com/ru/companies/kaiten/articles/979832/

#база_знаний #kaiten #документация #документация_проекта #проект #управление_проектами #знания_организации #хранение_информации

Корпоративная база знаний: как компании организовать хранение всех документов

Когда в компании нет порядка с внутренними материалами, нужная информация постоянно оказывается не там, где ее ищут. Из-за этого документы дублируются, никто не обновляет инструкции, а новые сотрудники дольше вникают в процессы. Чтобы этого не произошло, компании прибегают к созданию корпоративной базы знаний. Как легко систематизировать накопленные знания и как с этим может помочь Kaiten — в статье.

https://habr.com/ru/companies/kaiten/articles/979832/

#база_знаний #kaiten #документация #документация_проекта #проект #управление_проектами #знания_организации #хранение_информации

Принципы разработки в системном анализе

Документация может спасти проект или убить его, если подойти к ней без дисциплины В этой статье системный аналитик Влад показывает, как применять инженерные принципы — SRP, SSOT, ООП — не к коду, а к аналитике, описанию систем и документированию решений.

https://habr.com/ru/companies/sovcombank_technologies/articles/976100/

#системный_анализ #документация_проекта #документация_api #confluence #документация #swagger #yaml

Генеральная уборка базы знаний: плюсы, подводные камни, минусов не будет

Привет, Хабр. Меня зовут Мария Рылик, я — старший контент-менеджер группы управления пользовательским опытом веб-поддержки «Лаборатории Касперского». И полтора года назад я столкнулась с распространенной в техписовских кругах проблемой: децентрализованной базой знаний. Чтобы найти инфу по работе с конкретным продуктом, приходилось по крупицам искать ее в разных статьях, в большинстве своем имеющих мало общего с конкретной задачей, которую я пыталась решить. Из-за этого в поддержку приходилось обращаться даже в несложных ситуациях. В результате поддержка, вместо того чтобы использовать свое время для решения действительно сложных, специфичных проблем, была постоянно перегружена однотипными и достаточно распространенными вопросами, ответы на которые можно было бы поместить в отдельную статью. И все из-за отсутствия систематизированного подхода. В этой статье я расскажу, как мы с командой провели генеральную уборку баз знаний, наступили в процессе на всевозможные швабры грабли, но в итоге помогли и юзерам продуктов, и нашему саппорту: базами знаний стали активно пользоваться, снизилось количество итераций общения по проблеме от первого запроса саппорту до окончательного решения.

https://habr.com/ru/companies/kaspersky/articles/968582/

#техпис #технический_писатель #кейс #база_знаний #документация #документация_проекта #поддержка #service_desk #знания_в_проектах

Генеральная уборка базы знаний: плюсы, подводные камни, минусов не будет

Привет, Хабр. Меня зовут Мария Рылик, я — старший контент-менеджер группы управления пользовательским опытом веб-поддержки «Лаборатории Касперского». И полтора года назад я столкнулась с распространенной в техписовских кругах проблемой: децентрализованной базой знаний. Чтобы найти инфу по работе с конкретным продуктом, приходилось по крупицам искать ее в разных статьях, в большинстве своем имеющих мало общего с конкретной задачей, которую я пыталась решить. Из-за этого в поддержку приходилось обращаться даже в несложных ситуациях. В результате поддержка, вместо того чтобы использовать свое время для решения действительно сложных, специфичных проблем, была постоянно перегружена однотипными и достаточно распространенными вопросами, ответы на которые можно было бы поместить в отдельную статью. И все из-за отсутствия систематизированного подхода. В этой статье я расскажу, как мы с командой провели генеральную уборку баз знаний, наступили в процессе на всевозможные швабры грабли, но в итоге помогли и юзерам продуктов, и нашему саппорту: базами знаний стали активно пользоваться, снизилось количество итераций общения по проблеме от первого запроса саппорту до окончательного решения.

https://habr.com/ru/companies/kaspersky/articles/968582/

#техпис #технический_писатель #кейс #база_знаний #документация #документация_проекта #поддержка #service_desk #знания_в_проектах

Генеральная уборка базы знаний: плюсы, подводные камни, минусов не будет

Привет, Хабр. Меня зовут Мария Рылик, я — старший контент-менеджер группы управления пользовательским опытом веб-поддержки «Лаборатории Касперского». И полтора года назад я столкнулась с распространенной в техписовских кругах проблемой: децентрализованной базой знаний. Чтобы найти инфу по работе с конкретным продуктом, приходилось по крупицам искать ее в разных статьях, в большинстве своем имеющих мало общего с конкретной задачей, которую я пыталась решить. Из-за этого в поддержку приходилось обращаться даже в несложных ситуациях. В результате поддержка, вместо того чтобы использовать свое время для решения действительно сложных, специфичных проблем, была постоянно перегружена однотипными и достаточно распространенными вопросами, ответы на которые можно было бы поместить в отдельную статью. И все из-за отсутствия систематизированного подхода. В этой статье я расскажу, как мы с командой провели генеральную уборку баз знаний, наступили в процессе на всевозможные швабры грабли, но в итоге помогли и юзерам продуктов, и нашему саппорту: базами знаний стали активно пользоваться, снизилось количество итераций общения по проблеме от первого запроса саппорту до окончательного решения.

https://habr.com/ru/companies/kaspersky/articles/968582/

#техпис #технический_писатель #кейс #база_знаний #документация #документация_проекта #поддержка #service_desk #знания_в_проектах

Генеральная уборка базы знаний: плюсы, подводные камни, минусов не будет

Привет, Хабр. Меня зовут Мария Рылик, я — старший контент-менеджер группы управления пользовательским опытом веб-поддержки «Лаборатории Касперского». И полтора года назад я столкнулась с распространенной в техписовских кругах проблемой: децентрализованной базой знаний. Чтобы найти инфу по работе с конкретным продуктом, приходилось по крупицам искать ее в разных статьях, в большинстве своем имеющих мало общего с конкретной задачей, которую я пыталась решить. Из-за этого в поддержку приходилось обращаться даже в несложных ситуациях. В результате поддержка, вместо того чтобы использовать свое время для решения действительно сложных, специфичных проблем, была постоянно перегружена однотипными и достаточно распространенными вопросами, ответы на которые можно было бы поместить в отдельную статью. И все из-за отсутствия систематизированного подхода. В этой статье я расскажу, как мы с командой провели генеральную уборку баз знаний, наступили в процессе на всевозможные швабры грабли, но в итоге помогли и юзерам продуктов, и нашему саппорту: базами знаний стали активно пользоваться, снизилось количество итераций общения по проблеме от первого запроса саппорту до окончательного решения.

https://habr.com/ru/companies/kaspersky/articles/968582/

#техпис #технический_писатель #кейс #база_знаний #документация #документация_проекта #поддержка #service_desk #знания_в_проектах

Вайбкодинг — не Вайб и не Кодинг

Привет Хабр! Понимаю, что постов на эту тему появляется всё больше, вижу как их количество растёт. Все они подходят к проблеме с разных сторон — я хочу показать свою. Я фриланс-разработчик, 2 года опыта. В основном делаю телеграм-ботов и TG mini apps, иногда бывают заказы на лендинги, смарт-контракты и пентесты. Работаю на одной площадке — Кворк. Есть аккаунт на Fiverr, но там никто ни разу не писал, кроме мошенников... Последние полгода я делаю проекты только при помощи LLM. Я почти не читаю код и не пишу его совсем — только логи иногда добавляю. Готов к летящим помидорам. Хочу рассказать о том, что я только вырос: в доходе, эффективности, доверии заказчиков. За эти полгода мой доход вырос почти в три раза, я нашёл двух стажёров, и дело идёт в гору — появились крупные заказы. Но меня немного обескураживает, когда люди называют процесс разработки при помощи LLM "вайбкодингом". Я не могу назвать это ни вайбом, ни кодингом. Сейчас объясню почему.

https://habr.com/ru/articles/971496/

#вайбкодинг #llm #cursor #фриланс #документация_проекта #структура_проекта #развитие #заказы #боты_телеграм

Лучшие практики в Sequence-диаграммах для системных аналитиков

В данной статье я хочу поделиться опытом и рассказать о том, как системным аналитикам улучшить Sequence-диаграммы (диаграммы последовательностей) с помощью лучших практик. Я покажу, как некоторые подходы из мира программирования (те самые best practices и идеи из Clean Code ) помогают рисовать sequence-диаграммы чище и понятнее.

https://habr.com/ru/articles/969192/

#clean_code #plantuml #sequence_diagram #системный_анализ #системный_аналитик #best_practices #документация_проекта #диаграммы_последовательности #uml #umlпроектирование

Чужой среди своих: как аналитику войти в уже сработавшуюся команду

Привет! Меня зовут Инесса. Я — аналитик в компании fuse8. Предлагаю сегодня поговорить о том, как встроиться в уже сработавшуюся команду. По моему опыту, это всегда испытание. Почти как игра в русскую рулетку: не знаешь, как команда примет новичка и как быстро он подстроится под общий ритм. Новому человеку нужно время на адаптацию, обучение и погружение в процессы. И только потом можно по-настоящему оценить его вклад.

https://habr.com/ru/articles/960758/

#аналитика_проекта #коммуникация_в_команде #коммуникации_с_заказчиками #процессы_в_it #планирование_проекта #планирование_цикла_разработки #организация_процессов #документация_проекта

Чужой среди своих: как аналитику войти в уже сработавшуюся команду

Привет! Меня зовут Инесса. Я — аналитик в компании fuse8. Предлагаю сегодня поговорить о том, как встроиться в уже сработавшуюся команду. По моему опыту, это всегда испытание. Почти как игра в русскую рулетку: не знаешь, как команда примет новичка и как быстро он подстроится под общий ритм. Новому человеку нужно время на адаптацию, обучение и погружение в процессы. И только потом можно по-настоящему оценить его вклад.

https://habr.com/ru/articles/960758/

#аналитика_проекта #коммуникация_в_команде #коммуникации_с_заказчиками #процессы_в_it #планирование_проекта #планирование_цикла_разработки #организация_процессов #документация_проекта

Чужой среди своих: как аналитику войти в уже сработавшуюся команду

Привет! Меня зовут Инесса. Я — аналитик в компании fuse8. Предлагаю сегодня поговорить о том, как встроиться в уже сработавшуюся команду. По моему опыту, это всегда испытание. Почти как игра в русскую рулетку: не знаешь, как команда примет новичка и как быстро он подстроится под общий ритм. Новому человеку нужно время на адаптацию, обучение и погружение в процессы. И только потом можно по-настоящему оценить его вклад.

https://habr.com/ru/articles/960758/

#аналитика_проекта #коммуникация_в_команде #коммуникации_с_заказчиками #процессы_в_it #планирование_проекта #планирование_цикла_разработки #организация_процессов #документация_проекта

Чужой среди своих: как аналитику войти в уже сработавшуюся команду

Привет! Меня зовут Инесса. Я — аналитик в компании fuse8. Предлагаю сегодня поговорить о том, как встроиться в уже сработавшуюся команду. По моему опыту, это всегда испытание. Почти как игра в русскую рулетку: не знаешь, как команда примет новичка и как быстро он подстроится под общий ритм. Новому человеку нужно время на адаптацию, обучение и погружение в процессы. И только потом можно по-настоящему оценить его вклад.

https://habr.com/ru/articles/960758/

#аналитика_проекта #коммуникация_в_команде #коммуникации_с_заказчиками #процессы_в_it #планирование_проекта #планирование_цикла_разработки #организация_процессов #документация_проекта

Размышления о документации

Вряд ли найдётся кто-либо, кто в здравом уме и ясной памяти будет отрицать необходимость документации. Любой продукт имеет (или должен иметь) свою документацию. Как минимум – инструкцию о том, как этим продуктом пользоваться. Производители почти всегда указывают – « прежде чем начать пользоваться нашим продуктом, внимательно ознакомьтесь с инструкцией ». Но дело почти никогда не ограничивается инструкцией пользователя. Производители также составляют и другую документацию – техническую, эксплуатационную. Но ЧТО же должен создавать автор документации? Что должна в себя включать документация, когда, на каком этапе и в каком объёме она должна создаваться, ЧТО она должна содержать, когда, кому и при каких обстоятельствах она может потребоваться? В данной статье мы и поразмышляем об этом... Читать статью

https://habr.com/ru/articles/958076/

#документирование #документация #документация_проекта #документирование_проектов #управление_проектом #управление_продуктом #техническая_документация #технический_писатель

Размышления о документации

Вряд ли найдётся кто-либо, кто в здравом уме и ясной памяти будет отрицать необходимость документации. Любой продукт имеет (или должен иметь) свою документацию. Как минимум – инструкцию о том, как этим продуктом пользоваться. Производители почти всегда указывают – « прежде чем начать пользоваться нашим продуктом, внимательно ознакомьтесь с инструкцией ». Но дело почти никогда не ограничивается инструкцией пользователя. Производители также составляют и другую документацию – техническую, эксплуатационную. Но ЧТО же должен создавать автор документации? Что должна в себя включать документация, когда, на каком этапе и в каком объёме она должна создаваться, ЧТО она должна содержать, когда, кому и при каких обстоятельствах она может потребоваться? В данной статье мы и поразмышляем об этом... Читать статью

https://habr.com/ru/articles/958076/

#документирование #документация #документация_проекта #документирование_проектов #управление_проектом #управление_продуктом #техническая_документация #технический_писатель

Размышления о документации

Вряд ли найдётся кто-либо, кто в здравом уме и ясной памяти будет отрицать необходимость документации. Любой продукт имеет (или должен иметь) свою документацию. Как минимум – инструкцию о том, как этим продуктом пользоваться. Производители почти всегда указывают – « прежде чем начать пользоваться нашим продуктом, внимательно ознакомьтесь с инструкцией ». Но дело почти никогда не ограничивается инструкцией пользователя. Производители также составляют и другую документацию – техническую, эксплуатационную. Но ЧТО же должен создавать автор документации? Что должна в себя включать документация, когда, на каком этапе и в каком объёме она должна создаваться, ЧТО она должна содержать, когда, кому и при каких обстоятельствах она может потребоваться? В данной статье мы и поразмышляем об этом... Читать статью

https://habr.com/ru/articles/958076/

#документирование #документация #документация_проекта #документирование_проектов #управление_проектом #управление_продуктом #техническая_документация #технический_писатель

Размышления о документации

Вряд ли найдётся кто-либо, кто в здравом уме и ясной памяти будет отрицать необходимость документации. Любой продукт имеет (или должен иметь) свою документацию. Как минимум – инструкцию о том, как этим продуктом пользоваться. Производители почти всегда указывают – « прежде чем начать пользоваться нашим продуктом, внимательно ознакомьтесь с инструкцией ». Но дело почти никогда не ограничивается инструкцией пользователя. Производители также составляют и другую документацию – техническую, эксплуатационную. Но ЧТО же должен создавать автор документации? Что должна в себя включать документация, когда, на каком этапе и в каком объёме она должна создаваться, ЧТО она должна содержать, когда, кому и при каких обстоятельствах она может потребоваться? В данной статье мы и поразмышляем об этом... Читать статью

https://habr.com/ru/articles/958076/

#документирование #документация #документация_проекта #документирование_проектов #управление_проектом #управление_продуктом #техническая_документация #технический_писатель

TDMS Фарватер Web: смотрите онлайн-премьеру 30 сентября

Приглашаем на премьеру

https://habr.com/ru/companies/nanosoft/articles/949252/

#nanosoft #nanocad #web #браузеры #расширения #документация #документооборот #документация_проекта #электронная_документация #электронный_архив

Безумству храбрых… Как заставить ИИ понимать нормативные требования для проверки ЦИМ

Прошло целых два года, как команда NSR Specification твердо пообещала добиться автоматизации экспертизы цифровых информационных моделей (ЦИМ) за счет создания машинопонимаемых представлений требований стандартов проектирования. На тот момент мы очень хотели регулярно рассказывать о промежуточных результатах, но слишком увлеклись разработкой. Ежедневно возникали новые и новые проблемы, в муках рождались способы их решения, в спешке писались задачи на разработку, когда заканчивались слова мы рисовали картинки, потом, дрожащими руками тестировали новый функционал, с азартом отлавливали баги, умело замаскированные под фичи... Каждый раз нам казалось, что осталось только дождаться свежего релиза, и все, мы победили. Оглядываясь назад, мне все чаще кажется, что мы были немного сумасшедшими, раз взялись за эту задачу. Но это, наверное, к лучшему. Если бы тогда, в 2023 году мы знали обо всех сложностях, с которыми нам предстоит столкнуться, то сегодня не смогли бы похвастаться работающим решением. Теперь то уж точно нам есть о чем рассказать: решение работает и уже обкатано на нескольких пилотных проектах. Узнать все!

https://habr.com/ru/companies/nanosoft/articles/936874/

#llm #bim #инженерия #инженерные_системы #инженерные_практики #документация_проекта #документирование_проектов #автоматизация #автоматизация_бизнеспроцессов #ии

Безумству храбрых… Как заставить ИИ понимать нормативные требования для проверки ЦИМ

Прошло целых два года, как команда NSR Specification твердо пообещала добиться автоматизации экспертизы цифровых информационных моделей (ЦИМ) за счет создания машинопонимаемых представлений требований стандартов проектирования. На тот момент мы очень хотели регулярно рассказывать о промежуточных результатах, но слишком увлеклись разработкой. Ежедневно возникали новые и новые проблемы, в муках рождались способы их решения, в спешке писались задачи на разработку, когда заканчивались слова мы рисовали картинки, потом, дрожащими руками тестировали новый функционал, с азартом отлавливали баги, умело замаскированные под фичи... Каждый раз нам казалось, что осталось только дождаться свежего релиза, и все, мы победили. Оглядываясь назад, мне все чаще кажется, что мы были немного сумасшедшими, раз взялись за эту задачу. Но это, наверное, к лучшему. Если бы тогда, в 2023 году мы знали обо всех сложностях, с которыми нам предстоит столкнуться, то сегодня не смогли бы похвастаться работающим решением. Теперь то уж точно нам есть о чем рассказать: решение работает и уже обкатано на нескольких пилотных проектах. Узнать все!

https://habr.com/ru/companies/nanosoft/articles/936874/

#llm #bim #инженерия #инженерные_системы #инженерные_практики #документация_проекта #документирование_проектов #автоматизация #автоматизация_бизнеспроцессов #ии

Безумству храбрых… Как заставить ИИ понимать нормативные требования для проверки ЦИМ

Прошло целых два года, как команда NSR Specification твердо пообещала добиться автоматизации экспертизы цифровых информационных моделей (ЦИМ) за счет создания машинопонимаемых представлений требований стандартов проектирования. На тот момент мы очень хотели регулярно рассказывать о промежуточных результатах, но слишком увлеклись разработкой. Ежедневно возникали новые и новые проблемы, в муках рождались способы их решения, в спешке писались задачи на разработку, когда заканчивались слова мы рисовали картинки, потом, дрожащими руками тестировали новый функционал, с азартом отлавливали баги, умело замаскированные под фичи... Каждый раз нам казалось, что осталось только дождаться свежего релиза, и все, мы победили. Оглядываясь назад, мне все чаще кажется, что мы были немного сумасшедшими, раз взялись за эту задачу. Но это, наверное, к лучшему. Если бы тогда, в 2023 году мы знали обо всех сложностях, с которыми нам предстоит столкнуться, то сегодня не смогли бы похвастаться работающим решением. Теперь то уж точно нам есть о чем рассказать: решение работает и уже обкатано на нескольких пилотных проектах. Узнать все!

https://habr.com/ru/companies/nanosoft/articles/936874/

#llm #bim #инженерия #инженерные_системы #инженерные_практики #документация_проекта #документирование_проектов #автоматизация #автоматизация_бизнеспроцессов #ии

Безумству храбрых… Как заставить ИИ понимать нормативные требования для проверки ЦИМ

Прошло целых два года, как команда NSR Specification твердо пообещала добиться автоматизации экспертизы цифровых информационных моделей (ЦИМ) за счет создания машинопонимаемых представлений требований стандартов проектирования. На тот момент мы очень хотели регулярно рассказывать о промежуточных результатах, но слишком увлеклись разработкой. Ежедневно возникали новые и новые проблемы, в муках рождались способы их решения, в спешке писались задачи на разработку, когда заканчивались слова мы рисовали картинки, потом, дрожащими руками тестировали новый функционал, с азартом отлавливали баги, умело замаскированные под фичи... Каждый раз нам казалось, что осталось только дождаться свежего релиза, и все, мы победили. Оглядываясь назад, мне все чаще кажется, что мы были немного сумасшедшими, раз взялись за эту задачу. Но это, наверное, к лучшему. Если бы тогда, в 2023 году мы знали обо всех сложностях, с которыми нам предстоит столкнуться, то сегодня не смогли бы похвастаться работающим решением. Теперь то уж точно нам есть о чем рассказать: решение работает и уже обкатано на нескольких пилотных проектах. Узнать все!

https://habr.com/ru/companies/nanosoft/articles/936874/

#llm #bim #инженерия #инженерные_системы #инженерные_практики #документация_проекта #документирование_проектов #автоматизация #автоматизация_бизнеспроцессов #ии

Разработка требований к ПО с помощью Markdown, Git и Obsidian

Пошаговое руководство по использованию Git, Obsidian, Markdown и любимого IDE для разработки требований и трассируемого в них программного кода.

https://habr.com/ru/articles/927152/

#требования_заказчика #комментарии_в_коде #трассировка_требований #git #obsidian #версионность #версионирование #версионность_кода #документирование #документация_проекта

Разработка требований к ПО с помощью Markdown, Git и Obsidian

Пошаговое руководство по использованию Git, Obsidian, Markdown и любимого IDE для разработки требований и трассируемого в них программного кода.

https://habr.com/ru/articles/927152/

#требования_заказчика #комментарии_в_коде #трассировка_требований #git #obsidian #версионность #версионирование #версионность_кода #документирование #документация_проекта

Разработка требований к ПО с помощью Markdown, Git и Obsidian

Пошаговое руководство по использованию Git, Obsidian, Markdown и любимого IDE для разработки требований и трассируемого в них программного кода.

https://habr.com/ru/articles/927152/

#требования_заказчика #комментарии_в_коде #трассировка_требований #git #obsidian #версионность #версионирование #версионность_кода #документирование #документация_проекта

Разработка требований к ПО с помощью Markdown, Git и Obsidian

Пошаговое руководство по использованию Git, Obsidian, Markdown и любимого IDE для разработки требований и трассируемого в них программного кода.

https://habr.com/ru/articles/927152/

#требования_заказчика #комментарии_в_коде #трассировка_требований #git #obsidian #версионность #версионирование #версионность_кода #документирование #документация_проекта

Как применять чат-ботов с LLM для решения простых офисных задач

Добрый день, уважаемые читатели! Не так давно я проводил внутрикорпоративное мероприятие о том, как правильно применять чат-ботов, чтобы немного ускорить офисную рутину. Мероприятие очень понравилось аудитории, поэтому я решил переработать презентационный материал в статью - вдруг он принесет пользу еще кому-нибудь? Если вы уже используете приемы промт-инжиниринга - то, скорее всего, вы не найдете для себя ничего нового. Статья больше рассчитана на тех новичков, которые лишь «что-то слышали» о больших языковых моделях, но не используют их в работе, поскольку это «что-то на ITшном», «не понятно, как это может мне помочь», «я слишком занят, чтобы разбираться самому». Можете переслать эту статью вашим офисным коллегам 💼. Итак, поехали!

https://habr.com/ru/articles/923104/

#промт #документация_проекта #схемы

Как применять чат-ботов с LLM для решения простых офисных задач

Добрый день, уважаемые читатели! Не так давно я проводил внутрикорпоративное мероприятие о том, как правильно применять чат-ботов, чтобы немного ускорить офисную рутину. Мероприятие очень понравилось аудитории, поэтому я решил переработать презентационный материал в статью - вдруг он принесет пользу еще кому-нибудь? Если вы уже используете приемы промт-инжиниринга - то, скорее всего, вы не найдете для себя ничего нового. Статья больше рассчитана на тех новичков, которые лишь «что-то слышали» о больших языковых моделях, но не используют их в работе, поскольку это «что-то на ITшном», «не понятно, как это может мне помочь», «я слишком занят, чтобы разбираться самому». Можете переслать эту статью вашим офисным коллегам 💼. Итак, поехали!

https://habr.com/ru/articles/923104/

#промт #документация_проекта #схемы