3
0
mirror of https://github.com/larvit/adf-codec.git synced 2026-11-20 23:25:43 +01:00

Answer architecture round 1: 2 🔴, 4 🟡; refuse a link around only nodes that take none, mark the change breaking, file code-text marks

This commit is contained in:
2026-10-14 13:37:50 +02:00
committed by Lillem4n
parent d31efaba16
commit 6842f386ae
12 changed files with 96 additions and 45 deletions
+6 -4
View File
@@ -4,10 +4,12 @@
- `losslessMarkdownToAdf` names the CommonMark spelling to write when it refuses a directive whose
node CommonMark spells, such as `[![alt](url)](href)` for a linked `!adf:mediaSingle`.
- `losslessMarkdownToAdf` gives a `date`, `emoji`, `inlineCard`, `mention`, `status` or
`mediaInline` no mark Atlassian's schema withholds from it: `**!adf:mention[@A]{id=…}**` reads as
a plain mention, and a link around only such nodes reads as its destination, then the nodes.
`adfToLosslessMarkdown` writes a node holding such a mark as `!adf:carry`, so it still round-trips.
- **Breaking:** a mark spelling skips a `date`, `emoji`, `inlineCard`, `mention`, `status` or
`mediaInline` Atlassian's schema withholds the mark from, where `losslessMarkdownToAdf` gave it
the marks around it: `**!adf:mention[@A]{id=…}**` reads as a plain mention. A link around only
such nodes, or a directive mark around nodes none of which takes it, is `unsupported-node-shape`.
`adfToLosslessMarkdown` writes a node holding such a mark as `!adf:carry{json="…"}`. See
`MIGRATION.md`.
## 0.2.0