A reply (or comment) is a kind of post that is a text (typically, though photos are possible too) response to some other post, that makes little or no sense without reading or at least knowing the context of the source post.
Replies rarely have names/titles, though they sometimes have other structure like multiple paragraphs, or blockquotes from the source that are being specifically responded too.
Why reply on your own site
You should post replies on your own site so you can own your replies, regardless of what happens to the page or site you were commenting about.
Why send webmentions for replies
- To demo real-time comments showing up, e.g. on aaronparecki.com
Why fallback to pingback
If the thing you're replying to lacks a webmention endpoint, you should automatically look for a pingback endpoint and send that instead (e.g. in HEAD/GET results), to support posting comments on indieweb community member's sites that receive pingbacks but not webmentions, e.g. Laurent's Testing #indieweb federation.
Post a reply
How to publish an indieweb reply in response to an original post:
2. Link to the original
- If you are using the h-entry microformat to mark up your reply (as you should), add
class="u-in-reply-to"to that link as well, e.g.:
<div class="h-entry"> <a href="http://example.com/note123" class="u-in-reply-to">Some note with a point</a> <div class="p-name p-content">Good point! Now what is the next thing we should do?</div> </div>
3. Send a webmention from your server to the original's server (as detailed below). Ideally your server/software should automatically do the (3) webmention for all links in your post.
4. Include author information in your reply post so the original knows who is replying (and then send another Webmention so the original page gets the update).
Here's another example with explicit author name and icon, in case your site or blog does not already provide that on the page.
<div class="h-entry"> <a class="p-author h-card" href="http://mysite.example.org"> <img alt="" src="http://mysite.example.org/icon.jpg"/> Supercool Indiewebauthor</a>: in reply to: <a href="http://example.com/note123" class="u-in-reply-to">Some note with a point</a> <div class="p-name p-content">Good point! Now what is the next thing we should do?</div> </div>
Send Webmentions From Reply
Do proper webmention discovery:
- in particular do a HEAD request first, then GET if no endpoints found and type is text/html or application/xhtml+xml.
- simplest way to both minimize bytes requested by my server and avoid GETting non-HTML links (which I do link to plenty often in my posts)
- if no webmention endpoints found, do fallback discovery for pingback inside same HEAD/GET results and send pingback, using an approach like https://gist.github.com/aaronpk/5744879
POSSE a reply
To POSSE replies:
- Set silo-specific 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_idto the id of tweet the @-reply is a response to. This too should be automatically handled by your server/software. For details see:
- Add u-syndication link from original reply to POSSE copy
- Send a webmention from original reply to the post it is in reply to. If you already sent a webmention before adding the u-syndication link, send another webmention so the target has a better chance of deduplicating with any POSSE replies they've received, and preferring your original reply post.
Setting the silo-specific reply-to on POSSE copies helps silo readers better understand/follow what you're replying to 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.
- 2013-04-25: Aaron Parecki: http://aaronparecki.com/replies/2013/04/25/1/indieweb-qs
- 2013-05-12: Tantek Çelik: http://tantek.com/2013/132/t2/been-t-since-day-joined-2006
- POSSE copy: https://twitter.com/t/status/333649785062060034
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~=syndicationlinks, or if not found, then look for
class~=u-syndicationlinks 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.
- Proposed answer: at the permalink of the original post that you're replying to, look for
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.
Display a reply post
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
Update a reply
When you update a reply post on your site:
- explicitly note the datetime updated with a
dt-updatedproperty 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
- 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)
Delete a reply
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.
Accept a comment
How to receive an indieweb comment replying to an original post
- Listen for 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.
- 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.
Display received comments
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:
Disabling the commenting function on my home-brew blog software. Spammers, you win. Also, fsck you. http://blog.tomayac.com/index.php?date=2013-06-06&time=18:27:29&perma=Disabling+Blog+Comme.html :-(
tl;dr: reply is the post type, a comment is a reply syndicated into the context of the original.
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 - (part) of the post that is being replied to might be displayed (typically abbreviated, simplified, or de-styled) in a reply-context
- 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), likely 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.
- reply to a tweet: http://aaronparecki.com/replies/2013/01/27/1/
- syndicated copy: https://twitter.com/aaronpk/status/295714219544944640
- in-reply-to: https://twitter.com/veganstraightedge/status/295713694757834752
- reply to an indieweb post: http://aaronparecki.com/replies/2013/03/19/1/indiewebcamp
- reply to a tweet: http://aaronparecki.com/replies/2013/01/27/1/
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
- SoundCloud accepts comments in specific moments (seconds? microseconds?) of any published song or audio.
IndieWeb examples of displaying a reply post to a single original post (that original itself shown (partially) as context on the reply permalink) :
- also an example 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.
- reply post in-reply-to a photo, showing context:
- reply to multiple other posts
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.
Silo Examples of comment UIs/UX on posts.
Some silos have a comments embed which is used by various sites to host comments elsewhere:
- Disqus - their focus is to provide comments or ("discussion" - hence their name) sections on other pages.
- Facebook - see Comments Embed
- comments.network - show comments from hacker news or reddit on your page
Open source commenting embed:
- Juvia - a commenting system you can install on your own server similar to Disqus and Intense Debate
- e-comments - External comments for static HTML pages, a lightweight self-hosted disqus alternative.
Twitter @-replies versus quote tweets
A summary of IRC Chat on 2017-04-11 regarding how to emulate Twitter @replies versus quote tweets and how those might be syndicated to Twitter.
There seems to be 3 different elements of a tweet that are distinguished by an @-reply versus a quote tweet.
- Audience: An @-reply shows up in a Twitter User's Profile Page (firehose) and in the response section of the original tweet. A quote tweet shows up in the user's public tweet streams (showing up for users that follow that user).
- For the IndieWeb this means making a post that doesn't show up in streams (except maybe a firehose) and including a u-reply-to with the link of the post being replied to.
- Notification: An @-reply shows up as a specific reply post, where a quote tweet is more of a mention.
- For the IndieWeb this could mean sending a reply webmention versus a person-tag.
- Context: An @-reply expects the reader to understand the context of the reply already, where as a quote tweet is embedding and showing the context of the previous tweet to bring other people into the conversation as well.
- For the IndieWeb, this would relate to reply-context
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.
- reply-chain (threads)
- Comment Policies
- responses - other (specialized) types of replies