Skip to content

docs(tasks): an Atom summary is escaped twice - #17

Merged
adammharris merged 1 commit into
mainfrom
agent/backlog-file-an-atom-summary-escapes-twice
Nov 9, 2026
Merged

adammharris merged 1 commit into
mainfrom
agent/backlog-file-an-atom-summary-escapes-twice

Conversation

@adammharris

Copy link
Copy Markdown
Member

Files a task for a defect in the Atom feed. This PR adds a document and no code.

What's wrong. generate_atom_feed (plates-render/src/page.rs) builds each entry's <summary> by running the rendered HTML through strip_html_truncate and then xml_escape. Stripping the tags leaves the entities the renderer wrote (&amp;, &lt;, &gt;), and xml_escape escapes their & a second time. A body of Tom & Jerry <3 renders to <p>Tom &amp; Jerry &lt;3</p>, and its entry ends up with <summary>Tom &amp;amp; Jerry &amp;lt;3</summary>, which a feed reader shows as Tom &amp; Jerry &lt;3. <content> (CDATA) and the RSS feed are not affected.

The task also notes that strip_html_truncate measures its 280-character limit in bytes, not characters.

How it was found. I called generate_atom_feed and render_body from a throwaway test on main at 134b3b0. That test is not part of this PR.

Checks. prov check reports no findings. The change is documents only, so nothing builds.

The fix is left for its own branch, agent/backlog-an-atom-summary-escapes-twice.

@adammharris
adammharris merged commit a1c6399 into main Nov 9, 2026
8 checks passed
@adammharris
adammharris deleted the agent/backlog-file-an-atom-summary-escapes-twice branch November 9, 2026 20:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant