updated

From IndieWeb

πŸ†™


An updated is a post that has been edited by the author. It should have dt-updated with the datetime of the update for machines. For people it may have either text and optionally some other visual indicator to show which parts of the post were changed.

HTML has tags including <ins> and <del> for assisting in helping to mark up changes. Many CMS platforms include some basic CSS mark up for making these changes visually obvious. This paragraph is an example of how they display in MediaWiki with a strikethrough for <del> and an underline for <ins>.

Why

Updates to a post can improve it's content but can cause confusion, so clearly indicating updates helps address differences for both human and machine consumers.

  • Inform readers that the post has changed
    • Explains why it is different than the post they may previously have seen
    • Helps give context to comments that may no longer be relevant
  • Indicate that any copies of the content should be updated

How to

When a post is updated by the user, implementations should:

  • Show an indication that the post has changed, such as "Updated YYYY-MM-DD HH:MM" for readers.
  • Include dt-updated in an h-entry with the date the post was updated.
  • Send a webmention to all URLs that were either in the previous version of the post or the new version
  • Update any POSSE copies of that post. See POSSE Update for details.

IndieWeb Examples

Not sure who explicitly supports proper "updated" posts with dt-updated and automatic sending of webmentions to all URLs whether in the previous or new version of a post.

If you think you support updated posts properly, try http://webmention.rocks/ Update tests, if you pass them all, add yourself here with citations of your updated post(s).

bear

bear has implemented updated posts support on his site bear.im since 2016-04-15.

Example URL of an updated post:

Eddie Hinkle

Eddie Hinkle has implemented updated posts support on his site since 2018-11-03.

gRegor Morrill

gRegor Morrill has implemented updated posts support on his site since 2014-07-11.

Chris Aldrich

Chris Aldrich has used the dt-updated microformat on his updated posts since around 2015. Except for small spelling or grammar errors, he marks up larger changes in HTML with the <ins> tag which includes some CSS to highlight all or portions of the changed text as necessary for readers.

Anthony Ciccarello

Anthony Ciccarello has used the dt-updated microformat on his posts and includes a short description of the changes at the bottom of the post.

benji

benji has setup dt-updated on some of his posts. Based on a previous discussion at a HWC, he also marks movie watches using dt-published for when the movie was watched and dt-updated when the post actually was created.

Media Examples

Major media sites update their articles from time to time, e.g.

New York Times

The New York Times updated this article published 2017-03-24 within minutes of publication, with a revised article name and content edits:

Silo Examples

Facebook

Facebook supports editing posts and shows that a post has been "edited". (See versioning#Facebook for details).

Flickr

Flickr supports replacing the photo of a photo post, without changing its permalink, comments etc.

Brainstorming

Update POSSE copies

When you update a post, you should update its POSSE copies too if you can.

Notifying Responses

Issues

Threaded Comments Problems

Similar to deleted posts, but perhaps less disruptive, and updated post or comment may impact the relevance / meaning of subsequent replies.

See Also