What is a discussion?
Discussions are a great way to engage with the community around various topics!
We love this feature since it helps us surface insights from people who have already read the article.
Such insights vary widely and can often contain lots of useful and interesting information that can add a lot to the article (or can just compliment the author on a great article!).
How to participate in a discussion?
Click on any article in the feed to see the article modal.
Beneath the title, TLDR and article image you can see all the comments on the post.
You can be upvote (1), reply (2) to and share (3) individual comments. You can also see the number of upvotes a comment has on the right (4).
or you can add your own comment on the article itself.
Add a comment
There are two options to start/join a discussion:
- Click on the comment button in the article modal.
- Use the Companion widget.
The easiest way to start or join a discussion is to click on the comment icon at the middle-bottom of a post:
Once you click on the comment button, you will see the comment modal.
You can then leave a comment using markdown in the comment box (5).
Writing comments in markdown
You can use markdown when commenting on articles 🎉
- Headings (using
#for a h1 through to
######for a h6 )
- Text formatting like
- Lists (using
- Links (using
- Images and animated GIFs (using
`backticks around your code`)
- Blockquotes (using
> your quote)
- Code snippets (using
``` triple backticks on the lines before and after your snippet ```)
- and more, check out the markdown guide for more ways you can use markdown (not all features are supported).
We only support pure markdown in comments, HTML will be converted to plain text.
You can @mention people in comments! Simply type the @ character and start writing the first few characters of their name.
A list of matches will appear based on what you write, select the person you want to mention (6) and it will auto complete their name for you.
Once you post the comment they will be notified that you mentioned them (if they have notifications switched on)
Preview your comment
When writing a comment you can click on the "Preview" button at the top of the modal to check your comment looks great before posting!
We built some great and informative quality of life items into the article modal, such as:
Article meta data
All the details about this article, including the title (a), TLDR (b), tags (c), published date (d), reading time (e) and cover image (f).
Table of contents
daily.dev uses the headings in each article to build an automatic table of contents (7).
A great way to get a snapshot of the article and understand what it's about, in addition to the TLDR.
Suggested similar posts
Based on the article's data, daily.dev will also recommend further reading recommendations (8).
Additionally, we feature some of the most interesting discussions (9) currently available on the platform.
That way, you can engage with the community on the hottest topics without going back to the feed.
- Clicking on a particular row in the table of contents will open up the article on that specific heading.
- Clicking on the number of upvotes on a comment will display a list of the users who upvoted the post or comment (10).