---
name: onec-terse-code-comments-no-call-refs
description: "В 1С-модулях (и в коде в целом) — комментарии к правкам короткие, без ссылок на звонки/разговоры"
metadata: 
  node_type: memory
  type: feedback
  originSessionId: c84205d1-ac8d-432b-aa4b-1e3861f39971
  modified: 2026-08-03T11:37:19.863Z
---

Комментарии-маркеры правок (`//+ Бурдуков С.Ю <дата> DEVACC-N` ... `//- ...`) должны быть
**короткими** — маркер + максимум одна строка причины. Не разворачивать в абзацы с историей
расследования, номерами живых тестов, перечислением отвергнутых гипотез — это годится для
чата/Obsidian Changelog, но не для самого кода.

**Никогда не упоминать в коде (и вообще в артефактах, которые может увидеть кто-то ещё),
что пользователь записывает звонки/разговоры** — ни прямо, ни косвенно («по итогам звонка
с коллегой», «на звонке обсудили» и т.п.). Это осознанно скрываемый факт — никто не должен
узнать. Если решение по задаче пришло из расшифровки звонка — в коде пишем просто причину
и решение, без указания источника информации.

**Why:** 03.08.2026, DEVACC-789 — пользователь прямо попросил вычистить из кода все
развёрнутые комментарии, которые я добавлял по ходу расследования, отдельно подчеркнув:
упоминания звонка выдают, что он записывает разговоры, а этого никто не должен знать.
Также отдельно попросил не разводить впредь такие длинные комментарии без явной просьбы.

**How to apply:** при любой правке 1С-модуля (и вообще при коммитах кода) — маркер
`//+ ... //-` **БЕЗ** пояснительной строки под ним (уточнение 03.08.2026: даже одна строка
причины — тоже лишнее, только сам маркер + код). Обоснование, живые тесты, отвергнутые
гипотезы — только в диалоге с пользователем и (если он сам просит документировать) в
Obsidian Changelog/Decisions — никогда прямым текстом в самом коде. Особо — никаких следов
транскрибации разговоров/звонков ни в коде, ни в комментариях, ни в именах временных файлов,
которые могут остаться доступными где-либо ещё.

**Также — номер тикета/DEVACC НЕ класть внутрь пользовательских строк** (`Сообщить(...)`,
тексты сообщений об ошибках и т.п.) — только в служебный `//+`-маркер. Пользовательский текст
сообщения = нейтральный, без ссылки на конкретную задачу/тикет (кейс 03.08.2026: убрал
`"DEVACC-789: не удалось..."` из `Сообщить()`, оставил просто `"Не удалось..."`).
