Архив рубрики ‘документация’

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

Приглашаем на премьеру TDMS Фарватер Web – новой системы с удобным веб-интерфейсом для документооборота и управления проектированием в строительстве. Изображение

От хаоса к порядку: построение системы автотестов в условиях минимальных требований

Привет! Меня зовут Александр, я SDET-специалист в SimbirSoft. В этой статье я расскажу, как можно покрыть разрабатываемую часть проекта автотестами на ранних этапах его разработки, если в команде отсутствуют аналитики и присутствуют задокументированные требования только по основному функционалу. Эта статья будет интересна как джунам, так и техническим специалистам middle и выше, а также руководителям команд […]

Документация для AI: практические принципы разработки

Всем привет! Меня зовут Александр, я COO в SaaS-платформе аналитики данных. Последний год активно изучаю внедрение AI-решений в кросс-функциональные процессы. Делюсь полезными материалами, которые считаю стоят внимания. В основном про AI, изменение процессов, тренды и продуктовое видение. У себя в телеграм-канале делюсь сжатыми и структурированными саммери статей. Сегодняшний перевод отличного гайда по документации для AI […]

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

Три часа ночи. Прод лежит. А где у нас, собственно, что? Моя боль На работе я пришёл вести один Rails-проект, а через полгода у меня было уже два бэкенда (новый бренд и старый), сайт-документация, пара мобильных приложений и прошивка для умного замка. Репозитории разбросаны по разным местам, DNS в трех разных местах, CI, CDN, Docker […]

Как разработчики убивают бизнес

Доброго времени суток! Для начала представлюсь: я бэкенд-разработчик с опытом более 8 лет. Участвовал в разнообразных проектах: в стартапах, в галерах, в крупных корпорациях и в среднем бизнесе. К сожалению, найти идеальную статистику по данной теме не представляется возможным, однако из общения с бывшими коллегами я понимаю, что то, что будет описано ниже, — не […]

Экспорт из Yandex Wiki в Markdown. Не стали дожидаться и сделали сами

Всем привет! Меня зовут Катя, я развиваю Gramax, open source-платформу для управления технической документацией. В нашем чате и у пользователей регулярно встает вопрос переезда в Gramax c других платформ. Переезд с Confluence и Notion мы сделали прямо в интерфейсе приложения, а с Yandex Wiki — отдельной утилитой. Нет, мы не поленились, просто заметили, что сообщество […]

Как мы строили систему обучения, адаптации и проверки знаний новичков

Передача знаний: инструкция на случай ухода эксперта

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

Скрытые языки: как инженеры передают информацию внутри команды, избегая документации

Технические команды часто избегают лишней документации, но информация всё равно каким-то образом передаётся, сохраняется и развивается. В этой статье — попытка разобрать скрытые механизмы общения внутри инженерных команд: как выстраиваются негласные соглашения, каким образом рождаются «внутренние диалекты» и зачем вообще всё это, если есть JIRA, Confluence и куча других инструментов. Много примеров, блоков кода на […]

Obsidian для профессионалов: рабочая система заметок на стыке подходов

Обложка: гибридная система заметок в Obsidian