AI agents: fetch the documentation index at llms.txt. Markdown versions are available by appending .md to any page URL, including this page's markdown.
Comments
Talking about a task with the people you share a workspace with, and how comments differ from a task's own notes.
A comment is a message on a task. It sits with the task rather than in a separate conversation, so whoever picks the work up later reads it in the place it applies to. Anyone who can see the task can read its comments — for most tasks that is everyone in the workspace, and for a task in a private project it is that project's members.
Comments or notes?
Every task already has a description. That is the task itself: what needs doing, the link to the design, the acceptance criteria. Edit it as the work changes.
A comment is what people say about the task. "Blocked until Priya is back", "the client moved the date, I've pushed it a week", "this turned out to be two jobs, splitting it". Those belong in comments, because they are a record of a conversation rather than the current state of the work — and because rewriting the description would erase what was there before, while comments stack up in order.
If you are unsure: would replacing what is there now lose something? Then comment.
Writing one
Open a task and type into the comment box. Comments show oldest first, each with who wrote it and when.
You can edit your own comment after posting it. Edited comments are marked as edited — nobody sees a silent change to something they have already read. You cannot edit somebody else's; add your own comment instead of rewriting theirs.
Deleting a comment is permanent. Tasks go to Trash when you archive them and can come back, but comments have no Trash — a deleted one is gone. You can delete your own, and a workspace owner or admin can delete anyone's, which is there for tidying up something that should not have been posted.
There is a limit of 10,000 characters on a single comment, which is about four pages. If you are writing more than that, it probably belongs in the task's description or a document you link to.
Nobody gets a notification
Done Bear has no notification bell, no unread badges, and no @-mentions. A comment does not ping anyone, and nothing is marked as unread until it has been read.
That is deliberate. Reminders are the only thing that interrupts you, and you set those yourself. It does mean a comment is the wrong place for something urgent: if a colleague needs to know now, tell them the way you normally would. Comments are for the context that helps whoever opens the task next, which is often you in three weeks.
Where you can read them
Published with Blode.md