w3c / websub

WebSub Spec in Social Web Working Group

Home Page:https://w3c.github.io/websub/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Diffing for HTML with <article>

singpolyma opened this issue · comments

Suggestion: allow hubs to remove previously-delivered <article>s from content distribution just as previously-delivered Atom <entry> may be removed.

Or, better yet, allow conforming hubs to send only deltas in a "manner appropriate for the content type" and provide the <entry>/<article> cases as informative only.

We wanted to avoid needing to spell out diffing mechanisms for every conceivable format in the core spec.

The trick around this to technically remain spec compliant, while also not surprising consumers of the WebSub API, is to say that your WebSub-enabled URL returns only the latest item. That way you can send just the one <article> or whatever, and it still counts as "sending the full contents of the URL". In practice, it's fine to do this as long as the page you're sending has a concept of multiple items in a list, and if your consumers are ready to handle arbitrary numbers of items.

We wanted to avoid needing to spell out diffing mechanisms for every conceivable format in the core spec.

I get this, but why not just allow for format-specific diffing without specifying it? Show the atom one as an example and leave the specifics up to implementation.

I don't remember the exact reasoning anymore, but believe me there was a lot of discussion about this. You can probably dig up some of the past threads here if you're so inclined https://github.com/w3c/WebSub/issues?utf8=%E2%9C%93&q=is%3Aissue+is%3Aclosed+diff