Communities

(DEV) Codidact Meta
(DEV) Codidact Meta
(DEV) Writing
(DEV) Writing

Dashboard
Notifications
Mark all as read
Q&A

Post History

40%
+0 −1
Q&A Draft meta post

0 answers  ·  posted 5mo ago by Monica‭  ·  edited 5mo ago by UserA‭

#2: Post edited by user avatar UserA‭ · 2021-07-12T22:53:29Z (5 months ago)
Draft meta post
*This is an in-progress draft meta post for when threaded comments are ready to deploy.*

----

From our earliest discussions of what the Codidact platform would be, we've known that we had to tackle comments.  Comments are very important for giving feedback and asking for clarifications.  Some other platforms try to keep comments focused and prune the discussions that naturally happen too, but we know that doesn't work -- and sometimes it's not constructive.  Communities are made out of people and people like to discuss things.  The problem with discussions in comments on other platforms isn't the *discussions*; it's that someone coming to the page is presented with "57 more comments (click here)" and that's sad to navigate.

We've wanted *threaded* comments from the beginning, and now we have them, thanks to the efforts of luap42, ArtOfCode, Moshi, and our crew of people banging on a test server.

<!-- Make the names links in the real post. -->

*There are a lot of screenshots in this post.  Most of them are behind expanders.*

## Viewing threads

A post can have any number of **named comment threads**, which look like this:

![post with links to five threads and "show more"](https://a.dev.codidact.org/uploads/n5HNApRPNvxymbrbRQGzHJxu)

Each thread shows the number of comments, and threads are shown in order of recent activity, **most recent first**.

Click on a thread to expand it in place:

<details><summary>screenshot</summary>

![first five comments shown in place, with link to see the whole thread](https://a.dev.codidact.org/uploads/gvpEu1JECgH6xqAHCB1ur7mm)

</details>

You can collapse the thread to get it out of your way or leave it open and expand another thread.  To see the whole thread or to add a comment, click the link (either at the top or the bottom) to see the whole thread.  That takes you to a new page, like this:

<details><summary>screenshot</summary>

![full thread with a textbox at the bottom](https://a.dev.codidact.org/uploads/ZvU8jG8wwC7gGZfDwaxv7LrH)

</details>

You can **follow a thread**, which means you will get inbox notifications for new comments.  You'll automatically follow a thread if you comment in it or if it's on your post.  You can unfollow a thread you're following at any time using that "unfollow" link at the top of the thread page.

If you have the **Curate** ability you'll see a **Tools** link on the thread:

<details><summary>screenshot</summary>

![screenshot](https://a.dev.codidact.org/uploads/VPQhSYRsedPu7vA7qd3Tcwnv)

</details>

The tools are:

- **Rename**: edit the short description that shows under the post

- **Lock**: temporarily prevent new comments for a number of days that you specify

- **Archive**: lock the thread and show it as archived on the post list; meant for threads that are valuable for historical reasons but are done now

- **Delete**: lock and delete the thread; it remains visible to those with the Curate ability

Moderators have one more tool: they can see the list of people who are following a thread.

## Posting comments

You can add a comment to an existing thread from the full thread.

You can ping other participants in the thread (or the post author), as you can today, and there is now **auto-complete** -- type at least the first three characters of a name and matches are shown.  Click on the one you want.

![screenshot](https://a.dev.codidact.org/uploads/4RS29teWpBfYYB7LhrpdS9pb)

You can **create a new thread** using the "start a new comment thread" button under the list of threads on the post.  You'll be invited to type a comment and provide a name:

<details><summary>screenshot</summary>

![screenshot](https://a.dev.codidact.org/uploads/3ECUJvBfS9rmqW2fn1dmuMQ5)

</details>

## Flags

We don't have flags for individual comments yet, but we know that's important and we haven't forgotten.  We do now show *links* for all comments, so as a workaround, you can use that link in a flag on the post.

**This is experimental:** One of the flag options on a post is "needs author's attention".  If you choose that flag, what you type goes into the special "Post Feedback" thread instead of flagging the moderators.  The idea is to collect the "please fix this" comments in one place for easier review, but we don't know if that's actually valuable -- maybe people should just leave comments.  (We *do* want something like that for close votes, because we'll have a special place in the UI for closer-vote feedback.  But that's not the same as flags.)  Please give us feedback on this.

<details><summary>screenshot</summary>

![flag menu](https://a.dev.codidact.org/uploads/UHJUg5WWfiTmaCGM9SbmaBNH)

</details>

While taking that screenshot I noticed we're currently showing duplicate flags on answers.  Sorry 'bout that; please ignore.

## Transition

With this change, all **pre-existing comments** have been moved into threads named "General Comments".
#1: Initial revision by user avatar Monica‭ · 2021-06-24T01:13:36Z (5 months ago)
Draft meta post
*This is an in-progress draft meta post for when threaded comments are ready to deploy.*

----

From our earliest discussions of what the Codidact platform would be, we've known that we had to tackle comments.  Comments are very important for giving feedback and asking for clarifications.  Some other platforms try to keep comments focused and prune the discussions that naturally happen too, but we know that doesn't work -- and sometimes it's not constructive.  Communities are made out of people and people like to discuss things.  The problem with discussions in comments on other platforms isn't the *discussions*; it's that someone coming to the page is presented with "57 more comments (click here)" and that's sad to navigate.

We've wanted *threaded* comments from the beginning, and now we have them, thanks to the efforts of luap42, ArtOfCode, Moshi, and our crew of people banging on a test server.

<!-- Make the names links in the real post. -->

*There are a lot of screenshots in this post.  Most of them are behind expanders.*

## Viewing threads

A post can have any number of **named comment threads**, which look like this:

![post with links to five threads and "show more"](https://a.dev.codidact.org/uploads/n5HNApRPNvxymbrbRQGzHJxu)

Each thread shows the number of comments, and threads are shown in order of recent activity, **most recent first**.

Click on a thread to expand it in place:

<details><summary>screenshot</summary>

![first five comments shown in place, with link to see the whole thread](https://a.dev.codidact.org/uploads/gvpEu1JECgH6xqAHCB1ur7mm)

</details>

You can collapse the thread to get it out of your way or leave it open and expand another thread.  To see the whole thread or to add a comment, click the link (either at the top or the bottom) to see the whole thread.  That takes you to a new page, like this:

<details><summary>screenshot</summary>

![full thread with a textbox at the bottom](https://a.dev.codidact.org/uploads/ZvU8jG8wwC7gGZfDwaxv7LrH)

</details>

You can **follow a thread**, which means you will get inbox notifications for new comments.  You'll automatically follow a thread if you comment in it or if it's on your post.  You can unfollow a thread you're following at any time using that "unfollow" link at the top of the thread page.

If you have the **Curate** ability you'll see a **Tools** link on the thread:

<details><summary>screenshot</summary>

![screenshot](https://a.dev.codidact.org/uploads/VPQhSYRsedPu7vA7qd3Tcwnv)

</details>

The tools are:

- **Rename**: edit the short description that shows under the post

- **Lock**: temporarily prevent new comments for a number of days that you specify

- **Archive**: lock the thread and show it as archived on the post list; meant for threads that are valuable for historical reasons but are done now

- **Delete**: lock and delete the thread; it remains visible to those with the Curate ability

Moderators have one more tool: they can see the list of people who are following a thread.

## Posting comments

You can add a comment to an existing thread from the full thread.

You can ping other participants in the thread (or the post author), as you can today, and there is now **auto-complete** -- type at least the first three characters of a name and matches are shown.  Click on the one you want.

![screenshot](https://a.dev.codidact.org/uploads/4RS29teWpBfYYB7LhrpdS9pb)

You can **create a new thread** using the "start a new comment thread" button under the list of threads on the post.  You'll be invited to type a comment and provide a name:

<details><summary>screenshot</summary>

![screenshot](https://a.dev.codidact.org/uploads/3ECUJvBfS9rmqW2fn1dmuMQ5)

</details>

## Flags

We don't have flags for individual comments yet, but we know that's important and we haven't forgotten.  We do now show *links* for all comments, so as a workaround, you can use that link in a flag on the post.

**This is experimental:** One of the flag options on a post is "needs author's attention".  If you choose that flag, what you type goes into the special "Post Feedback" thread instead of flagging the moderators.  The idea is to collect the "please fix this" comments in one place for easier review, but we don't know if that's actually valuable -- maybe people should just leave comments.  (We *do* want something like that for close votes, because we'll have a special place in the UI for closer-vote feedback.  But that's not the same as flags.)  Please give us feedback on this.

<details><summary>screenshot</summary>

![flag menu](https://a.dev.codidact.org/uploads/UHJUg5WWfiTmaCGM9SbmaBNH)

</details>

While taking that screenshot I noticed we're currently showing duplicate flags on answers.  Sorry 'bout that; please ignore.

## Transition

With this change, all **pre-existing comments** have been moved into threads named "General Comments".