A comment is a kind of post that is in reply to some other post, that makes little or no sense without reading or at least knowing the context of the source post.
Comments rarely have names/titles, though they sometimes have other structure like multiple paragraphs, or blockquotes from the source that are being specifically responded too.
How to publish an indieweb comment replying to an original post
- Write a post (note/article/comment) on your own site
- Link to the original with rel="in-reply-to"
- If you are using the h-entry microformat to mark up your comment (you should), add class="u-in-reply-to" to the link as well
- Send a webmention from your server to the original's server
Ideally your server/software should automatically do the (3) webmention for all links in your post.
POSSE a reply
- Set proprietary reply-to on POSSE copies. E.g. when POSSEing notes to Twitter that are themselves @-replies (or you can find a POSSE'd copy on Twitter of the post that you're commenting on), set the
in_reply_to_status_id to the id of tweet the @-reply is a response to. This too should be automatically handled by your server/software. For details see:
This is so that when B posts a reply to A's post and sends a webmention, and both A and B POSSE their posts, wherever they happen to both POSSE to (e.g. on Twitter), their POSSE'd copies link-up there as well. That way those on the silo (e.g. Twitter), will be able to follow the conversation, even when A and B are replying/linking directly peer-to-peer between their indieweb posts.
Indieweb examples of a reply post that was automatically POSSE'd to Twitter with the in-reply-to-status-id set to the POSSE Twitter copy of the original post being replied to.
As an implementer, consider this in question form:
- When you post a reply regarding an indieweb post, do you also when POSSEing your reply to Twitter give it the in_reply_to_status_id of the Twitter copy of the original indieweb post (that you're commenting on)?
Auto-discovery of the POSSE'd copy on Twitter of the post that you're commenting on:
- How do I find POSSE'd copies of the post that I'm replying to? (e.g. in "To POSSE replies" above, to be able to "find a POSSE'd copy on Twitter of the post that you're replying to")
- Proposed answer: at the permalink of the original post that you're replying to, look for
rel~=syndication links, or if not found, then look for
class~=u-syndication links inside the h-entry. See posts-elsewhere which describes how links to syndicated copies of posts are published today and suggests markup for doing so.
- If no rel-syndication or u-syndication links are found (thus not finding a POSSE'd copy to Twitter of the post that you're commenting), consider providing a UI (e.g. an input field) for the author of the reply to manually enter in the URL of the POSSE'd copy on Twitter of the post that they're commenting on.
- See: posse-post-discovery for an algorithm and more details.
Auto-discovery of an original post from its POSSE'd copy that you're replying to:
- How do I find an original post of a POSSE'd copy that I'm replying to?
- e.g. in "Link to the original" in the "Make a comment" section above, it would be better if your implementation automatically detected when you're trying to reply to a POSSE'd copy (e.g. a tweet), auto-discovered the original, and linked to the original post instead (much more indieweb-friendly).
- in short:
- look for a rel=canonical link in the POSSE'd copy that links back to an original - use that
- otherwise if a parenthetical permashortlink is the last thing in the POSSE'd copy, convert that to a URL, and do the next step that URL as the last thing
- otherwise if a URL is the last thing in the POSSE'd copy, go retrieve that URL and see if it links back to the POSSE'd copy with rel=syndication then use that URL
- See: original-post-discovery for more details.
How to display your own replies / comment posts on your own site.
(This section could use expansion, details)
- First, show the context of what you're replying to, whether you're replying to single original post, or posting a multiple-reply
- Consider unwrapping shortened URLs in that context, e.g. URLs of shortener domains t.co, bit.ly, j.mp, etc. both in display and in href.
- The rest of your presentation should be consistent with whatever kind of reply you've posted, e.g. a note or an article
When you update a reply post on your site:
- explicitly note the datetime updated with a
dt-updated property in the h-entry of the reply
- "Updated: <time class="dt-updated">YYYY-MM-DD HH:MM:SS</time>" presentation up to you
- send another webmention to the original post with your updated reply's permalink.
If a server receives a webmention for an existing comment, the server should:
- re-request the reply permalink that it was sent
- if it returns a 410 GONE, the server should deleted it. See handling deleted posts.
- otherwise re-retrieve the reply h-entry and
- make sure it's still in-reply-to the original (if not, but still links back, downgrade it to a mention. if neither, then treat it as deleted and remove/tombstone accordingly per handling deleted posts).
- update the content of the comment on your site
- perhaps note the dt-updated for display purposes
- Apart from the content, converspace has also been updating h-card info (author name, url, photo) and reply type (mention, reply, like, repost) which has been useful when the source URL does not have proper markup when making the initial webmention and then fixes it for subsequent webmentions — Www.sandeep.io 03:43, 26 June 2013 (PDT)
- The time-period to update a comment should be limited (f.e. 5 min) so that none could destroy the context of a result discussion, by editing the whole comment. --Matthias Pfefferle
- This should be dependent on the target. Targets could employ different strategies like storing versions of comments (like Facebook does) or just mark a comments as being edited with a list of edit timestamps. — Www.sandeep.io 04:03, 26 June 2013 (PDT)
- If you are moderating new comments, don't forget to also moderate updates. -Www.sandeep.io 20:22, 7 July 2013 (PDT)
When you delete a reply post on your site, you server should send webmentions to all the links you mentioned in your post.
When your server gets a request for the permalink of the reply that was deleted, it should return the 410 GONE HTTP status code.
For more details see: handling deleted posts.
How to receive an indieweb comment replying to an original post
- Listen for pingback/webmention on your server (have your server software support)
- Link to it if it refers to a permalink on your site, and display it (or a summary) under your original post at that permalink.
- let any comments pop up automatically at some URL, e.g.
- Perhaps make this available as a PuSH-subscribable feed, giving you notifications for free
- only show comments under posts with authors that pass an intelligent whitelist/manual approval
- commenter is mentioned in the note they're replying to
- commenter is in your contacts list
- commenter is 1, 2, etc degrees of separation from you
Even better would be if original post(s) had a "Reply" webaction button which upon clicking, took the reader/commenter to their own blog's posting interface, with a (2) Link to the original (to make a comment) already pre-filled-in to which the commenter could simply add text commentary and then post.
So you've implemented accepting webmentions, now how do you display them on your site?
- Parse the source of the webmention for (the first) h-entry.
- If the hyperlink in the h-entry to the webmention target has in-reply-to markup, display the h-entry (summary/content abbreviated as necessary) in a "Comments" section, perhaps in the post footer. See comments-presentation for details.
- Otherwise if the hyperlink to the original post lacks in-reply-to markup, then add it to a "Related Articles" or "Mentions" section, again in the post footer.
Beware if you receive and display comments, apparently spammers are now attacking indieweb-like blogging solutions:
Content hosting / blogging software:
- There are open source libraries for pingback and webmention that you can use to add this functionality to your own blogging software.
examples of displaying a reply post to a single original post (that original itself shown (partially) as context on the reply permalink) :
Aaron Parecki has been using p3k to post replies to aaronparecki.com since ????-??-??. E.g.
See also: reply-context for more examples of replies.
Is a "reply" (or are replies) just a special case of a comment?
Replies on Twitter typically start with a name reference (@-name, indieweb URL).
Whereas comments only sometimes start with an explicit name reference.
Another distinction (perhaps useful for indieweb discussions) is context:
- A reply is the permalink to a reply post.
- A comment is the syndicated copy of a reply shown below (or otherwise adjacent to) the original post (that the reply is in-reply-to), perhaps copied there via a webmention notification and parsing microformats2 h-entry markup at the reply permalink.
More evidence/distinctions/use-cases welcome.
Examples of Replies
IndieWeb community members's replies (comments) on their own site in reference to a post on some other site:
Best practice - threaded POSSEd tweets - replies posted on the indieweb site and POSSE'd to Twitter such that the syndicated tweet links back to tweet that is being replied to - thus threading the tweets together on Twitter and providing a good experience there.
Adhoc / prose replies - prose and inline links being used to indicate what's being replied to:
- tantek.com - using "in-reply-to: URL" prose in the post itself.
Whilst most commenting implementations allow comments on the post level, an increasing number of silos are allowing granular comments on, for example, words, sentences or paragraphs:
- Medium allows per paragraph comments, using Twitter as commenter sign-in/identifier. Select text in a paragraph also brings up a plus (+) and a tweet button. The (+) button simply enables/adds to the comments for the paragraphs, whereas the tweet button quotes the selected text in a Twitter-specific Tweet web action that pops up a window to complete the action on Twitter. Very similar interaction as the select-to-quote webaction with post verb in the web action toolbelt.
- Branch discussions can be forked on sentence level
- The “Real World Haskell” online book has per-paragraph comments (example)
- TheyWorkForYou have annotations for each statement in Hansard (the official record of what is said in the British Parliament). These are shown inline. Examples: 1, 2
What is the difference between
rel attributes are scoped to the entire page, microformats u-* classnames are scoped to the closest ancestor with class=h-*. Therefore on a page listing replies it would make little sense to have rel=in-reply-to links for all the replies on the page as they’d all be scoped to the list page, whereas it’d be completely appropriate to have u-in-reply-to properties on each of the h-entries.
tl;dr: use u-in-reply-to everywhere, and rel=in-reply-to on post permalink pages.
Some silos have a comments embed which is used by various sites to host comments elsewhere: