Social Media Ideas for Комментарии К Документации

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

Сразу дисклеймер: это рассказ про инструмент, который мы написали для себя и используем каждый день. Ссылку дам в конце, продавать не буду — расскажу про проблему и как её решали,...

73 замечания начальника как датасет: делаем цифрового двойника рецензента

У меня есть руководитель, который очень хорошо ревьюит документы. Настолько хорошо, что один его проход по моим текстам породил 73 комментария. За один день.Первая реакция была ожи...

Внутренняя документация, которую никто не читает. Как сделать, чтобы читали (на примере ONLYOFFICE Workspace)

Документация умирает не от лени сотрудников, а из-за неудобства и потери доверия к данным. Разбираем «два кита» качественной базы знаний: удобство использования и контроль актуальн...

Как я год загружал фото в Битрикс24 и собрал все грабли файлового API

Работа с файлами в REST API Битрикс24 — та задача, где документация заканчивается ровно там, где начинаются проблемы. Официальные примеры показывают, как загрузить один файл в одно...

Комментарии в МАКС: как включить и писать их с iPhone

Включаем комментарии в канале МАКС на айфоне. Показываем, как их оставлять и почему кнопки может не быть.

Три исправления в upstream SPDK: баги, которых не видно на штатной нагрузке

Open Source силён, когда это улица с двусторонним движением.В основе uStor — нашей программно‑определяемой системы хранения — используется несколько Open Source‑компонентов. Один и...

Одна ошибка, и ты ошибся: как сохранить доверие к ИТ-продукту

Привет, Хабр! Меня зовут Мария, я технический писатель в ИнфоТеКС. Представьте: вы запускаете новое приложение, тщательно проработанное, с инновационными возможностями и безупречны...

6 ошибок миграции в Битрикс24 Диск, из-за которых портал приходится переделывать через полгода

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

Меня разнесли в комментариях к прошлой статье. Разбираю, где читатели правы

Две недели назад выложил сюда разбор 60 тысяч составов. Комментаторы за два дня нашли в алгоритме четыре дыры — про две я знал и молчал, про две не догадывался. Разбираю все четыре...

Как я перестал разрывать архитектуру на десяток документов — и сделал свой C4-редактор

Инструмент: C4 QuietGridLabs. Можно открыть демо без авторизации: проект будет храниться локально в браузере.Иногда архитектура «есть» — но пользоваться ею невозможно.На доске лежи...

«Сведения о выплатах устарели» и «Информация о стоимости устарела». Инструкция по обновлению в реестре российского ПО

Если вы правообладатель ПО из реестра отечественного ПО и увидели в реестровой записи розовые плашки «Сведения о выплатах устарели» или «Информация о стоимости устарела» - не игнор...

Правильный код мы отклоняем — и так задумано

Мой валидатор забраковал ответ, сославшись на несуществующую статью, — а ведь именно он поставлен ловить галлюцинации. После этого я собрал конвейер из восьми открытых пакетов: он...

А как у них-2: как регистрируют программы в Европе

Под моей статьёй с разбором реестра российского ПО в комментариях спросили: интересно, а как регистрируют программы за рубежом. Под статьей с разбором, как регистрируют программы...

Я полностью перешёл на SDD

Точнее, на Spec Kit от GitHub. Полгода назад я бы над этим посмеялся: спеки, планы, декомпозиция задач - привет из 2010-го, когда это называлось waterfall и все дружно от него убег...

Мы поставили ITAM за три недели. А работать он начал через полгода

Система блестит, дашборды красивые, а спросишь её что попроще — врёт. Потому что залили мёртвые данные и сократили углы на справочниках. Рассказываю, как внедрял, где обжигался и ч...

Ошибка в расчёте скидки, которую не видно глазами: проверяем ответ API по документации, когда автотестов нет

Есть класс ошибок, которые проходят все ручные проверки и спокойно доезжают до продакшена. Не пятисотки, не пустые поля, не сломанная структура — с этим как раз всё в порядке. Речь...

DE. Путь файла по слоям

В исходном orders.csv было 11 строк. До BI-витрины дошло 7, а валовая сумма 4720.30 после применения бизнес-правил превратилась в 2200.30 выручки. Четыре строки не исчезли: каждая...

Строка «resumes from where it stopped» увела меня в ветку форума 2021 года и в пять вопросов к движку автоматизации

Строка из документации n8n про возобновление с места остановки читается как гарантия перезапуска с точки сбоя. Проверка привела в ветку форума 2021 года, где смысл настройки объясн...

Qwen3.8-Flash-Next и важность прогона бенча в три раза на конфиг

Новая архитектура Qwen4 против продакшн-27B на трёх прогонах и назойливая ошибка в собственной документации про NVFP4A16. Переходим с 3.8-27B на Next-Flash или нет? Читать далее

Input Parameters Manual

Релиз DataSafeS3 v1.3.0

Что делать, если Docker Desktop и L2 multicast живут в разных мирах, а доказать failover кластера перед тегом v1.3.0 всё равно нужно? Под капотом: SSH-контейнеры, unicast keepalive...

README врёт: как я сделал open‑source линтер, который сверяет документацию с реальным репозиторием

README редко ломается в один момент.Обычно он просто постепенно перестаёт соответствовать проекту: переименовали команду, перенесли файл, удалили .env.example, сменили package mana...

Реверс-инжиниринг версии файла формата КОМПАС-3D

Некоторое время назад понадобилось массово определять, в какой версии КОМПАС был создан файл без установки самой программы. Задача возникла при обработке большой базы чертежей и мо...

Агентская разработка и Documentation Driven Development: когда ИИ пишет не код, а контракты

Привет, Хабр! Я Матвей Лихота, старший Go-разработчик. В предыдущем материале я показывал, как получить Go-код из OpenAPI. Теперь хочу сделать еще один шаг назад — к моменту, когда...