Рубрика «документация»

Как мы потеряли GitBook за 5 минут и нашли Gramax — open-source альтернативу, которую теперь используем сами - 1

Пишет об этом Product Manager команды: Котельникова Екатерина Андреевна.

Читать полностью »

Недавно на Хабре вышла статья Ивана Потапенко «Зачем и как избавляться от незаменимых сотрудников». Там про bus factor, про бутылочное горлышко, про ротацию, про дубляж знаний и работу вслух. Выглядит убедительно. Автор с 20 летним опытом, управлял отделами, доклад на конференции. Но есть одна проблема.

Иван описал идеальную команду в идеальном мире. Мир, где все хотят читать документацию. Где сотрудники сами пишут статьи в Wiki. Где ротация воспринимается с энтузиазмом, а не как «опять этот менеджер придумал». В реальности живут другие люди.

Читать полностью »

О себе

Всем привет. Меня зовут Никита, я руковожу командой Цикл-ОН. Мы уже более 5 лет ведем проекты по заказной разработке ПО и, как и многие, сталкиваемся с необходимостью разработки не только качественного кода, но и документацию на продукты. В нашей нише особенность, что заказчики живут в парадигме ГОСТа. Я бы здесь хотел оставить небольшую заметку о нашем опыте — как то, что для начаиналось как откровенное мучение превратилось сначала в умную идеологию, а по итогу в самостоятельное решение для подготовки документации — Платформа «ГОСТ‑ОН».

С чего все началось

Читать полностью »

Всем привет! Я системный аналитик в компании «СИБИНТЕК-СОФТ». Последние несколько лет занимаюсь разработкой ИТ-продуктов и сталкиваюсь с одной и той же проблемой – документация есть, но ее не читают. В чём причина — в лени разработчиков или в плохо написанной документации? Давайте разберёмся.

Важно: речь в статье идёт именно о внутренней технической документации для команды разработки: архитектурных решениях, описании сервисов, API и т.д. Это не про инструкции пользователей или администраторов и не про проектную документацию для заказчика.

Проблематика

Читать полностью »

Однажды мне пришла задача «реанимировать» документацию по фиче. Бизнес-логика, API, база данных, UI — всё было свалено в кучу, в одно сплошное полотно текста. И проблема была не столько в объёме, сколько в полном отсутствии структуры. Читать это было тяжело. Поэтому свои требования я организую иначе.

Я декомпозирую требования на отдельные артефакты. Каждая единица самодостаточна, а связи с остальными лишь дополняют картину всей фичи. Но тогда возникает вопрос: «Как ориентироваться в требованиях, если они разбросаны по wiki?». Для этого я и пишу пользовательское требование.

Читать полностью »

Frame 44.png

I. Предисловие: «Неотправленное письмо»

Задумывались ли вы когда-нибудь, с чего на самом деле начинается великая игра? Не с первой строчки кода. Не с первого полигона модели. И даже не с концепт-арта. Она начинается с мысли, которая была поймана и пригвождена к бумаге.

Читать полностью »

Нейро-дайджест: ключевые события мира AI за 1-ю неделю января 2026 - 1

Привет, это новый выпуск «Нейро-дайджеста» — коротких и полезных обзоров ключевых событий в мире искусственного интеллекта и технологий. 

Меня зовут ВандерЧитать полностью »

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

DITA расшифровывается как Darwin Information Typing Architecture. Фактически это формат, основанный на Читать полностью »

Привет! Снова.

Docker уже давно стал стандартом, и базовые команды вроде docker rundocker build или docker compose up знакомы любому разработчику. Но экосистема и инструментарий контейнеризации гораздо глубже.

В этом материале мы отойдём от банальных инструкций и разберём шесть продвинутых инструментов и настроек. Думаю, вы узнаете для себя что-нибудь новое.
Читайте первую часть по ссылке.


Dive: Рентген для образов

DiveЧитать полностью »

С развитием нашей компании и выходом на новые рынки (а магазины Fix Price работают не только в России, но также в ряде стран ближнего зарубежья и даже в ОАЭ) значительно увеличилось число задач по согласованию первичных договоров аренды. За 2024 год на согласование контролёру поступило 919 новых договоров аренды, а за первую половину 2025 года — уже 438. Поскольку с первого раза договоры в большинстве случаев не согласовываются, они возвращаются на доработку, и количество задач специалиста возрастает в разы.

Читать полностью »


https://ajax.googleapis.com/ajax/libs/jquery/3.4.1/jquery.min.js