Статья
Память агента: что стоит хранить, а что вредно
Почему у агента нет памяти, а есть файлы, которые кто-то кладёт ему в контекст; какие пять поводов оправдывают постоянную запись, какие шесть видов записей активно вредят …
База знаний
Тема: документация
35 материалов в этой теме.
Материалы
11 на странице
Статья
Операторы, движки и время: механика запроса
Что из синтаксиса поиска действительно работает, почему длинный естественный запрос хуже трёх существительных, как ограничивать выдачу площадкой и временем, чем …
Статья
Коммиты и pull request: короткий текст, который читают чаще всего
Как писать заголовки коммитов, тела сообщений и описания pull request на английском: разбор реальных формулировок, что в них слышит носитель и как переписать.
Статья
Инженерный английский: карта трека и для кого он не подойдёт
Зачем нужен отдельный трек про английский в рабочих ситуациях инженера, чем он принципиально отличается от курсов языка, какой базовый уровень он предполагает и в каком …
Статья
Документирование: user story, use case, спецификация, критерии приёмки
Как выбрать форму записи требования и довести её до состояния, в котором по ней можно писать код и тесты: анатомия user story, шаблон use case, структура рабочей …
Статья
Документация, которую вы видите впервые
Протокол первых двадцати минут в незнакомой документации: как понять её устройство и версию, где физически лежат самые полезные разделы, какими словами искать внутри неё …
Статья
Документация API: справочник, примеры, контракт
Под словом «документация API» живут три документа с тремя читателями: справочник для того, кто уже пишет код, примеры для того, кто оценивает вас за пятнадцать минут, и …
Статья
Асинхронная переписка: письма, чаты, статусы
Как писать письма, сообщения в чате и статусы на английском так, чтобы ответ пришёл с первого раза: разбор реальных формулировок, декодер чужой вежливости и шаблоны, …
Статья
RFC и проектные документы: как выносить решение на обсуждение
RFC — не описание системы, а запрос на возражения до того, как они станут дорогими: когда открыто окно для такого документа, из каких разделов он состоит, как …
Статья
README: первое, что видит новый человек
README отвечает на три вопроса за шестьдесят секунд — что это, как это запустить и к кому идти дальше; разбираем анатомию файла на парах «плохо / переписано», метрику …
Статья
ADR: запись архитектурного решения, которая переживёт автора
ADR пишется для инженера, который через два года решит, можно ли снять то, что вы поставили: устройство полей, почему запись нельзя редактировать, разбор плохих и …
По этому запросу ничего не найдено.