36 lines
3.9 KiB
Markdown
36 lines
3.9 KiB
Markdown
## Why
|
||
|
||
Описание и комментарии в карточке задачи веб-приложения показываются исходником вики-разметки Jira: `h3. Контекст`,
|
||
`# пункт`, ` * пункт`, `*жирный*` видны как символы, длинные структурированные описания (контекст, шаги
|
||
воспроизведения, критерии готовности) читаются плохо. Хаб хранит эти поля как есть (`description`, `body` — wiki,
|
||
требование «Таблица issue» data-model), разбора разметки в приложении нет — так записано в требовании «Карточка задачи».
|
||
|
||
Решения владельца 17.10.2026 (brainstorming, jira-hub#53):
|
||
- показывать описание и комментарии **так, как их показывает Jira** — рендер вики-разметки Jira, а не Markdown;
|
||
Markdown-конструкции в наших описаниях (обратные кавычки, `- пункт`) выглядят так же, как в Jira;
|
||
- исходник остаётся доступен: **кнопка у каждого блока** — у «Описания» и у каждого комментария отдельно.
|
||
|
||
## What Changes
|
||
|
||
- **Веб-приложение, карточка задачи:**
|
||
- «Описание» и текст каждого комментария показываются отрендеренной вики-разметкой Jira: заголовки `h1.`–`h6.`,
|
||
`*жирный*`, `_курсив_`, `-зачёркнутый-`, `+подчёркнутый+`, `^верхний^`, `~нижний~`, `{{моно}}`, списки `*` / `#` / `-` с вложенностью,
|
||
таблицы `||заголовок||` / `|ячейка|`, блоки `{code}`, `{noformat}`, `{quote}`, `bq.`, ссылки `[текст|url]`, `[url]`
|
||
и голые URL, упоминания `[~логин]`, ключи задач проекта (`AURORA-123`, открывают карточку в окне), `----`, разрыв строки `\\`;
|
||
- всё, что разборщик не знает (`{panel}`, `{color}`, картинки `!файл!` и прочее), выводится обычным текстом как есть;
|
||
- у «Описания» (в заголовке раздела) и у каждого комментария (в строке автора) — кнопка «исходник» / «текст»;
|
||
исходник выглядит как сейчас — текст с сохранёнными переносами; при каждом открытии карточки всё показано
|
||
отрендеренным, выбор не запоминается;
|
||
- свёртка длинного описания («развернуть» / «свернуть») работает в обоих режимах.
|
||
- Разметка разбирается в браузере собственным модулем на TypeScript в React-элементы; `innerHTML` /
|
||
`dangerouslySetInnerHTML` не используются, новых зависимостей нет.
|
||
|
||
## Non-Goals
|
||
|
||
- Хаб (API, данные, MCP) и агент не меняются; MCP `issue` по-прежнему отдаёт исходник.
|
||
- Markdown не разбирается.
|
||
- Полный набор макросов Jira (`{panel}`, `{color}`, `{anchor}`, `{toc}`, вложения-картинки, эмодзи `:)`, типографика
|
||
`--` / `---`) — нет; неразобранное видно текстом.
|
||
- Подсветка синтаксиса в `{code}` — нет.
|
||
- Рендер разметки вне карточки (список «Задачи», доска, «Служебные заметки») — нет.
|