Feedjoltdocs
Core concepts

Comments

Public discussion and private internal notes on the same Feedjolt post. Markdown, mentions, threading, pinned and incognito comments, moderation and edits.

Every post has two parallel comment threads:

  • Public comments - visible in the portal. End users and members both write here.
  • Internal comments - visible only to ADMIN and OWNER. Useful for triage notes, ACME-signed-the-contract context, "let's bundle this with #142".

Posting a comment

You must be signed in. End users sign in via magic link or OAuth (same flow as members). Posting requires:

  • A non-empty body.
  • The board's visibility allows the user.

Comments support Markdown and @mentions. Mentioning a member sends them a notification.

Threading

Comments can have one level of replies (parent -> child). We chose not to support deep threading because public feedback discussions tend to spiral. One level is enough to acknowledge "good point" without hiding the original topic three levels deep.

Internal comments

When writing a comment, ADMINs see a checkbox Internal note. Tick it and the comment is invisible to end users. The post's public thread shows no indication that internal notes exist.

Internal comments are useful for:

  • Linking to internal docs or design files.
  • Capturing context from sales/support conversations.
  • "Let's not promise this until we ship X first."

Pinned comments

ADMINs can pin one comment per post. Pinned comments appear above all others. Use this for canonical "here's what we decided" responses to avoid burying them under newer chatter.

Incognito comments

When commenting on a public board, end users can choose to post incognito - their name is hidden from the public view. We still record their identity internally for moderation; they can edit/delete their own comments.

Editing and deleting

Authors can edit and delete their own comments. ADMINs can delete any comment (including end-user ones). Edited comments show an "edited" indicator with a timestamp.

Moderation

If a comment is flagged as spam (manually by an ADMIN or by future auto-moderation), it's hidden from the public view but kept in the database for audit. ADMINs can recover it.

Notifications

Subscribe to comment.created events at Settings -> Notifications -> Subscriptions to get pinged on new comments - per-board or workspace-wide.

On this page