From 9f938beeeada5d079c1d6aeaeba4854c6660b3ae Mon Sep 17 00:00:00 2001 From: Lilleman auf Larv Date: Tue, 17 Nov 2026 00:44:27 +0100 Subject: [PATCH] =?UTF-8?q?Answer=20product-owner=20round=201:=200=20?= =?UTF-8?q?=F0=9F=94=B4,=203=20=F0=9F=9F=A1=20(0=20misread);=20read=20a=20?= =?UTF-8?q?smiley=20by=20its=20next=20character,=20compare=20panel=20colou?= =?UTF-8?q?rs=20without=20case=20and=20record=20where=20Jira's=20reading?= =?UTF-8?q?=20differs?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/decisions.md | 3 ++- spec/wiki.md | 8 +++++--- 2 files changed, 7 insertions(+), 4 deletions(-) diff --git a/docs/decisions.md b/docs/decisions.md index 7a721ae..7cd8ab3 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -1504,7 +1504,8 @@ that back as `info`, so `tip` rides the carry. That overturns the writer panel's Where Jira's reading differs, the spec keeps its own, since the writers' output must read back deep-equal and Jira's reading doesn't: `[~name]` reads as a `mention` with `id` `unknown`, `??x??` as `em` prefixed by `— `, a link's `|title` is dropped, header cell text carries `strong`, `{noformat}` -has no `language`, and an unknown `{code:}` reads `java`. +has no `language`, an unknown `{code:}` reads `java`, a `bgColor` outside the five reads as +the nearest-looking panel type, not `info`, and a backslash before `:` stays text. ## A plain wiki spelling stands for the attributes Jira's editor writes, and any other attribute rides the carry diff --git a/spec/wiki.md b/spec/wiki.md index 78ef987..2ea6ea3 100644 --- a/spec/wiki.md +++ b/spec/wiki.md @@ -42,7 +42,7 @@ string. | `codeBlock` holding one text node, of `language` `""` or a name below in lowercase | `{code:}`, a line feed, the text, a line feed, `{code}`; for `""`, `{noformat}`, the text, `{noformat}` the same way | the same, reading a `{code:}` name in lowercase and `{noformat}` as `language` `""`; `{code}` reads `java`; `title`, `borderStyle` and the other panel parameters drop | | `heading` | `h1. ` to `h6. ` by `level` | the same | | `mediaSingle` of `layout` `center`, holding one external `media` and no caption | `!!`, or `!\|alt=!` where `alt` holds none of `!`, `\|` and `,` | the same, reading `layout` `center`; `thumbnail`, `align` and the other parameters drop | -| `panel` of `panelType` `error`, `info`, `note`, `success` or `warning` | `{panel:bgColor=}`, a line feed, its blocks, a line feed, `{panel}`, the colour being `#ffebe6` for `error`, `#deebff` for `info`, `#eae6ff` for `note`, `#e3fcef` for `success` and `#fffae6` for `warning` | the same; a `title` parameter reads as the panel's first paragraph in `strong`; `{panel}` and any `bgColor` the five spellings leave out read as `info` | +| `panel` of `panelType` `error`, `info`, `note`, `success` or `warning` | `{panel:bgColor=}`, a line feed, its blocks, a line feed, `{panel}`, the colour being `#ffebe6` for `error`, `#deebff` for `info`, `#eae6ff` for `note`, `#e3fcef` for `success` and `#fffae6` for `warning` | the same; a `title` parameter reads as the panel's first paragraph in `strong`; `{panel}` and any `bgColor` the five spellings leave out read as `info`, colours compared without case; the other parameters drop | | `paragraph` holding content | its inline content | the same; a line feed in it reads as a `hardBreak`, as Jira renders it | | `rule` | `----` | the same | | `table` of `isNumberColumnEnabled` `false` and `layout` `default`, plain rows, each cell holding one paragraph | per cell, `\|\|` for a `tableHeader` and `\|` for a `tableCell`, then its paragraph, the row closed by the last cell's delimiter; an empty paragraph as a space | the same; a space-only cell reads as an empty paragraph, and a whitespace-only text rides the carry; reads `isNumberColumnEnabled` `false` and `layout` `default` | @@ -102,8 +102,10 @@ The writers never write these, and the reader reads them as follows: - `{anchor:name}` reads as nothing, since no ADF node holds a bookmark. - `!name.ext!` reads as its text: no ADF node holds an attachment by name. - `---` and `--` read as `—` and `–`. -- A smiley reads as the `emoji` Jira reads it as. The `emoji`'s `text` is the character where its `id` - is a code point, else its `shortName`. +- A smiley reads as the `emoji` Jira reads it as, wherever the next character is not a letter or a + digit and whatever comes before it: `x:)` and `f(x)` read, `a:Pb` and `:)x` don't, and a backslash + before it stops it. The `emoji`'s `text` is the character where its `id` is a code point, else its + `shortName`. | Smiley | `shortName` | `id` | | --- | --- | --- |