документация.

AnythingLLM: чат по своим документам без подписки OpenAI

Представьте, вот у вас на диске папка с договорами, сотня PDF, конспекты и внутренняя документация. Вы открываете ChatGPT, загружаете один файл — он его читает. Загружаете больше — контекст переполняется, или файл банально теряется. А если файлов десять? Двадцать? Подписка стоит денег, из России нужен VPN, и даже с ним модель не знает, что написано в ваших таблицах, пока вы не скормите ей всё вручную.

продолжить чтение

Прощай, платный перевод: собираем локализацию на open source и LLM

Мы в отделе технической документации переводим много текста: технические справочники, интерфейсные строки, исходный код и комментарии к нему. Счет идет на сотни документов в самых разных форматах, которые нужно постоянно переводить. Платный облачный CAT-сервис, которым мы пользовались, обходился все дороже и все меньше был под нашим контролем. Мы решили эту проблему сами: подняли on-premise инфраструктуру локализации с LLM, почти без участия разработки. В статье пошагово разбираю, как мы к этому пришли — от выбора между Zing и Weblate до финального пайплайна с Serge, Dify и своей моделью.

продолжить чтение

От Word по почте до ИИ‑скиллов: обсудим эволюцию документации и зачем нейросетям бизнес‑контекст

От пыльных папок и кучи email к единому репозиторию с документацией

продолжить чтение

Я не хочу читать то, чего вы не писали

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

продолжить чтение

МАЯК: сначала документация, потом кнопки

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

продолжить чтение

Markdown, который вы не замечали: от двух пробелов до интерактивной статьи

Я собирался написать статью про Markdown. В процессе внутри документа оказался Doom.До игры ещё доберёмся. Но сначала — почему два пробела меняют поведение абзаца, обратные кавычки не всегда спасают таблицу, а одинаковый .md на Хабре и GitHub может оказаться двумя разными документами.Для тридцатой статьи я выбрал Markdown. После расширения, которое сохраняет публикации Хабра в .md, хочется разобраться и с самим форматом: что он умеет, где удивляет и почему один файл в разных редакторах выглядит по-разному.

продолжить чтение

Аналитик и ИИ: три инструмента, которые превращают хаос в требования

Мы работаем на крупном проекте, где присутствует десятки интеграций, сотни бизнес-сценариев, документация в Confluence, а теперь ещё и описания бизнес-сценариев с помощью ИИ прямо в репозиториях. Это здорово выручает для погружения в проект, но всё равно не покрывает всю картину при работе над конкретной доработкой. Поэтому в команде аналитиков мы начали заводить собственных ИИ-агентов: собираем в папку нужные репозитории из Git, БФТ от заказчика, заметки со встреч, и вместе с агентом проектируем и анализируем.

продолжить чтение

Docs-as-code для медицинских систем: как перевести 1160 страниц из MS Word в Asciidoctor и автоматизировать сборку

Вам в наследство досталось руководство пользователя МИС на 1160 страниц в формате .docx, тысячи повторяющихся скриншотов, процесс обновления вызывает глубокую грусть. Что с этим «добром» делать?В этой статье я расскажу о своём проекте по переводу такой документации на рельсы docs-as-code: переосмысление структуры, укрощение размера скриншотов, борьба с кириллицей в Asciidoctor, настройка автоматической сборки HTML и PDF через GitLab CI/CD.

продолжить чтение

Как документировать API: частые ошибки и лучшие практики для создания своего руководства

Через дата-инженеров Далее

продолжить чтение

В проспекте на IPO Anthropic говорится об «экзистенциальной угрозе» для человечества

Согласно проспекту эмиссии для IPO, с которым ознакомилось агентство Reuters, компания Anthropic делает масштабную ставку на то, что искусственный интеллект преобразит мировую экономику более радикально, чем индустриализация, электрификация и появление интернета.

продолжить чтение

123456...8