3
0
mirror of https://github.com/larvit/adf-codec.git synced 2026-11-19 06:35:44 +01:00

Answer prose round 1: 0 🔴, 5 🟡 (0 misread); split the decision paragraph, move the Invalid ADF Macro evidence to the carry entry, and fix the comment and test names

This commit is contained in:
2026-11-17 03:22:07 +01:00
committed by Lillem4n
parent 55f8675d6a
commit 4654431ca0
3 changed files with 14 additions and 12 deletions
+11 -9
View File
@@ -1453,9 +1453,11 @@ alt text.
Wiki markup has no spelling for some nodes and marks, a layout among them. The lossless wiki
writer wraps each such node's ADF JSON in Jira's own `{adf}` macro: `{adf:display=block}` for a
block node, `{adf:display=inline}` for an inline node or each node of a marked run. The round-trip holds, and
Jira still renders the document. The lossy wiki writer ships beside it for consumers who want wiki
markup alone: it drops the form of what wiki markup cannot spell and keeps its content.
block node, `{adf:display=inline}` for an inline node or each node of a marked run. A
`{adf:display=inline}` holding an array shows "Invalid ADF Macro", where one holding a node renders
it. The round-trip holds, and Jira still renders the document. The lossy wiki writer ships beside
it for consumers who want wiki markup alone: it drops the form of what wiki markup cannot spell and
keeps its content.
Confirmed 2026-11-16 on a live Jira Cloud site: a description holding `{adf:display=block}` around
a `table` node's JSON rendered a table, and `{adf:display=inline}` around a `status` node's JSON
@@ -1510,12 +1512,12 @@ the nearest-looking panel type, not `info`, and a backslash before `:` stays tex
Checked again 2026-11-17 for the lossless writer's backslashes and inline carries. Jira drops the
backslash before `(`, `)`, `?`, `!`, `#`, `[`, `]`, `{`, `}`, `*`, `+`, `-`, `^`, `_` and `~`, and
keeps it as text before `:`, `;`, `.`, `,`, a letter, a digit and another backslash. So a backslash
before a smiley's `(`, or its closing `)`, stops it (`:\)` reads as the text `:)`), while `:D`, `:P`,
a `:` or `;` ending a node inside a line, and the `h` of `h1.` and the `b` of `bq.` at a line's start
ride the carry. An escaped `|` still ends a table cell, so a text holding `|` rides the carry there;
`|`, `\\`, `\"` and `\n` inside a carry's JSON survive in a cell and in a paragraph. A
`{adf:display=inline}` holding an array shows "Invalid ADF Macro", where one holding a node renders
it, so a run of nodes is one macro per node.
before a smiley's `(`, or its closing `)`, stops it (`:\)` reads as the text `:)`). No backslash
stops `:D`, `:P`, a `:` or `;` ending a node inside a line, or the `h` of `h1.` and the `b` of `bq.`
at a line's start, so a text holding one rides the carry.
An escaped `|` still ends a table cell, so a text holding `|` rides the carry there. `|`, `\\`,
`\"` and a newline inside a carry's JSON survive in a cell and in a paragraph.
## A plain wiki spelling stands for the attributes Jira's editor writes, and any other attribute rides the carry