diff --git a/AGENTS.md b/AGENTS.md index 5fb1150..06f5087 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -174,9 +174,9 @@ The verdict lands in `docs/decisions.md`. - A finding inside the chunk's item is fixed in the chunk. Outside it, a new `todo.md` item, always in a release, weighed against every item on that release by the personas and `docs/decisions.md` §Plain markdown is a flavour of the grammar through §Names stay text — an item it outweighs moves - later. A weighing no rule decides is asked as a gap. + later. A weighing no entry decides is asked as a gap. - A stated number — 500 levels, the branch floor — is kept; a chunk that cannot keep it asks, - naming the number it can reach. A number the code needs and no rule states is a gap. + naming the number it can reach. A number the code needs and no entry states is a gap. - An earliest release with no items left and nothing shipped toward it is planned as the chunk: every later item weighed as above, the order written in `todo.md`, and the maintainer's approval taken before any code. With work shipped toward it, it is ready to cut: report that and stop. diff --git a/docs/decisions.md b/docs/decisions.md index 56207dc..b3a8464 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -51,22 +51,23 @@ a `codeBlock` outside text — the error result names that instead. ## Foreign HTML sorts three ways -2026-08-23, the sort 2026-09-20, the maintainer. Goals 1 and 6. Valid while ADF holds no node for a -bare container, a comment or a script. +2026-08-23, the sort 2026-09-20, the maintainer. Goals 1, 3 and 6. Valid while ADF holds no node +for a bare container, a comment or a script. Lands with `todo.md` 6. Every foreign element `htmlToAdf` and `markdownToAdf` read sorts one of three ways, never a silent -drop of what a reader saw: +drop of content: - A container around document content that ADF has no node for unwraps to its children, its own - attributes dropped: `
text
` keeps `text`. + attributes dropped: `
text
` keeps `text`, losing the alignment. - Content ADF cannot hold is an error result naming it. A comment is one: a person wrote those words, and neither of Atlassian's schemas holds them — `annotation`'s `inlineComment` carries an id, `placeholder` is the editor's own hint, `extension` names a vendor app. - What is not document content drops whole: `