DEV Community

Cover image for How to create an ideal commenting system?

Posted on • Originally published at on <time datetime="2019-09-04T09:26:11Z" class="date">Sep 4, 2019</time>

How to create an ideal commenting system?

The first rule of the internet: Don't read the comments.

-- Ralph Breaks the Internet

First of all this is not a technological problem, the problem is sociological. People don't follow the same patterns when they communicate online and offline when they talk to people who they know and people who they don't know.

Second part of the problem is that text is a poor medium for conversation. Comments are bad, Twitter is the worst - it is build to escalate miscommunication and hot-takes.

Third part is the scale at which people got connected. It is very hard to moderate current volumes of information.

There is no solution to the problem, but there are approaches.

Code of conduct

Berlin code of conduct. A code of conduct for all user groups and conferences

This is a social problem - no amount of technologies alone will solve it. Required step (IMO) is to have CoC.

For example: CoC, Geek Feminism Blog comment policy.


Screenshot of StackOverflow counter near the answer

Karma system can help to moderate at scale. Karma system is based on positive and negative reactions to comments (and blog posts). The tricky part here is to make the score invisible otherwise it gets gamified e.g. people try to increase karma to score higher ranks.

Example: doesn't have a scoreboard and doesn't show a number of followers in contrast to hacker news and reddit.

StackOverflow uses reputation to limit which actions are available for users.

See no evil

photo of "three wise monkeys" sculpture

Photo by HUNTER LEONARD on Unsplash

The approach in which negative responses or reactions are hidden. This is done to avoid pitchforks. Moderators can contact person with a big number of negative reactions to inform, that this is an inappropriate comment. Or it can be a different situation - the comment was appropriate and negative reaction caused by intolerant people (and instead we can flag all of them).

Example: doesn't have public negative reactions.


Screenshot of reactions interface

Likes have been criticized because it is not a very big range of reactions, sometimes it is not appropriate.

On the other hand, some reactions, which are typically implemented as emojis are very confusing, for example, wink emoji (😉) can be confusing.

Example: GitHub comments have 8 reactions: 👍 👎 😄 🎉 😕 ❤️ 🚀 👀.

Expiration date

Screenshot of GitHub locked conversation

Ability to comment on old posts can be misused by trolls to harass people. It can be very time consuming to answer all the posts, so instead of an obligation to answer to the posts infinitely, people can choose to lock comments after some period.

If people would like to continue the conversation they can create a new post.

Example: GitHub lock bot

Rate limit

Screenshot of GitHub locked conversation

To avoid overheated conversation we can force some pauses between comments to prevent emotional responses people would regret later.

Example: hackernews flame detector.

Algorithms for spam detection

Algorithms can be used to detect spam. The algorithm can be as simple as track number of link per post or tracking keywords.

Examples: Akismet

Algorithms for tone detection

Modern algorithms (ML, AI) can be used to detect the tone of the message. The problem is that those algorithms are imprecise. The solution is to use tone detection, but don't block based on it instead show the score to commenter so they would be aware.

Examples: Google’s Perspective API, Conversation AI, Tone Analyzer, Sentiment Analysis.


Screenshot of Youtube flags

To help to moderate comments system can provide flags, so the user can help with the moderation process. Flags are helpful if they are granular and clearly defined, examples of categories: spam, offtopic, NSFW, spoiler, etc.

Logical fallacies

Screenshot of

Typical set of flags can be extended with logical fallacies.

Examples: arguman.


Screenshot of Stackoverflow badges

Gamification should be avoided because the main purpose is to have a constructive conversation instead of triggering mechanical reactions in response to the game system.

I like Discourse approach here:

Hmm, there are really three kinds of badges:

“learn the system” badges which are easy to get and bronze. I don’t know if there’s any downside to people doing this – the whole point is to learn how things work, so @name mentioning someone the very first time to “get a badge” is, I think, entirely the objective @Drew_Warwick. You can get these in a single day because they are the alternative to reading the manual, which nobody wants to do, and ain’t nobody gonna not never do nohow.

“keep coming back” badges which are harder to get and silver. These take longer to get, and I doubt anyone who isn’t interested would bother.

“long term contributor” badges which are gold. Good luck gaming these, if you game these then you just became a long term contributor, so… we all won?


Possible layouts for comments:

  • threaded comments (spatial-relation), for example,
  • non-threaded comments (temporal-relation), for example, Discourse
  • inline comments (similar to comments with quotes), for example, Notion
  • "debate graph", for example, arguman or debate tools.

As well we can choose how to order comments:

  • by time (oldest, newest)
  • by popularity (number of reactions)


Screenshot of GitHub issue editor

There are two main approaches for editors: WYSIWYG and markdown + preview, for example:


Images and gifs can partially improve text as a medium. On the other side, they add a11y issues (alt text, animations) and ambiguation.


There are a lot of other considerations to take into account, for example, edits, mentions, permalinks, etc. "The Comments Lab" nicely show-offs all options.


Main sources of inspiration for this post:

Cover photo by HUNTER LEONARD on Unsplash

Discussion (5)

yaser profile image
Yaser Al-Najjar

Thank you for mentioning that, not so many people talk about how communities are built.

And, commenting systems are pretty powerful tool in building those.

One thing I would like to add:


I had an experience in Reddit once, they were talking about the new version Visual Studio, I commented that VS is eventually doomed cuz it's bloated and I find VSCode pretty lightweight and a much better alternative in so many ways.

The topic gone viral, and I got lots of bad comments and dislikes. Since that time, I hardly comment on Reddit.

stereobooster profile image
stereobooster Author

Yeah, this is what I meant to convey in "See no evil" section. Even if downvotes are present they should not be visible.

moopet profile image
Ben Sinclair

I think it's worth bringing up the Stack downvote option. It costs you reputation to vote something down, which (theoretically) makes trolls think twice before carpet bombing your comment history.

It could be improved, maybe, by removing the penalty if someone else upvotes a comment you make on the answer, something like that, but it gets a bit messy.

Thread Thread
stereobooster profile image
stereobooster Author

It costs you reputation

This what I would call Karma-system. But the point is that don't show negative response to the public at all (though it can be used for some internal rating, it can be visible to moderators)

mehdiraash profile image
Mehdi Raash • Edited on

This recap and review ware needed, Thanks.
Maybe some techniques can be introduced for comment reader, to inform that you read this, like a simple read button to select a comment as read and then dim that comment.