Skip to content

Help dock description ru

Alex Miarsky edited this page Nov 10, 2026 · 1 revision

Док «Описание»

Описание показывает и редактирует текст текущего sObject, процесса или снапшота и умеет закрепить один текст как описание следующего чекина.

Текущая цель

В заголовке указаны точные объект и область показанного описания. Выбор в Поиске, процесс и снапшот могут менять цель. Режим редактирования создаёт локальный черновик; смена выделения не записывает его молча в другой объект.

Элементы

Элемент Поведение
Редактировать Открывает текущий текст как черновик.
Сохранить Записывает черновик в его текущую цель.
Отмена Удаляет только этот черновик и возвращает сохранённый текст.
Закрепить Использует это описание для чекина при дальнейшей смене выделения.
Открепить Снова выбирает описание по текущему контексту.

Док различает состояния Редактирование, Не сохранено, Сохранение и Для чекина. Закреплённый текст не копируется в описание другого объекта, а только выбирается для Очереди отправки.

Обычная последовательность

  1. Выберите нужные объект, процесс или снапшот.
  2. Проверьте заголовок цели до редактирования.
  3. Измените и сохраните хранимое описание.
  4. Закрепите его, только если оно должно перейти в следующий подготовленный чекин.
  5. После чекина открепите, чтобы снова следовать за текущим выделением.

Состояния и ошибки

  • Нет описания означает, что у цели пока нет сохранённого текста.
  • Нет цели означает, что рабочее пространство не опубликовало подходящее выделение.
  • Ошибка сохранения оставляет черновик для исправления и повтора.
  • Закрытие или скрытие дока не сохраняет редактируемый текст автоматически.

Реализация Stream

Открытие: «Панели рабочего пространства» → «Просмотр» → «Описание». Текущие DescriptionEditor.qml/state_detail_editing.py перенесены с отступом 8px, шагом 6px, исходной типографикой и компактными кнопками 28px. Объекты/снапшоты сохраняются тем же штатным update(search_key, {description: text}), что и в ТХ. Текст процесса служит локальным описанием/вводом для чекина: у него нет ключа записываемого объекта. Pin следует за выделением, Unpin возвращает описание текущей цели. Черновики переживают смену выделения и скрытие дока; к ним возвращает видимый список сохранённых черновиков. Они живут в памяти сессии, не являются резервной копией на диске. Выход/reload предупреждает о несохранённых правках. Штатный update использует последнюю запись, как ТХ: параллельные правки не объединяются. Ошибка сохранения оставляет текст для повтора. Общие docking, floating/maximize и presets леяутов включают эту панель.

Закреплённый текст заполняет новые формы Save snapshot/Clipboard/Revision текущего проекта. Редактирование формы не меняет Pin; уже подготовленные операции очереди сохраняют собственный текст. Интеграция Drop Plate и полного Snapshot Browser остаётся в плане рабочих панелей. Штатное выделение ссылок экранирует HTML и открывает skey/tactic-search через существующий маршрут проекта.

Clone this wiki locally