Discussing a policy

Overview

Every policy detail page has a Discussion section where you can ask questions, share configuration tips, and reply to other users. Comments are public — anyone browsing the catalog can read them — but you must be signed in to post, edit, or delete.

Open any policy from the Policies page and scroll to Discussion (or use the Discussion quick link at the top of the page).

The whole Discussion card, each thread's replies, and each individual comment can be collapsed independently — everything is expanded by default.

Posting a comment

Sign in, then type your comment in the box at the top of the Discussion section and click Comment. Comments support GitHub-flavored Markdown — use the Write / Preview tabs to check formatting before posting. bold, italic, lists, code, links, and tables all render.

There is a soft daily limit on how many comments you can post, to keep the discussion free of spam. If you hit it, you'll see a message and can post again the next day.

Replying

Click Reply under any top-level comment to respond to it. Replies are shown indented beneath the comment they answer.

Threading is a single level deep: you reply to a top-level comment, not to another reply. This keeps long discussions readable rather than letting them nest indefinitely.

Editing and deleting your comments

Under a comment you posted you'll see Edit and Delete.

• Edit reopens the Markdown editor. An edited comment is marked (edited).
• Delete removes your comment. If it has replies, they stay in place and your comment is shown as a [comment deleted] placeholder so the thread still makes sense. This can't be undone.

References

• Getting started — signing in and finding policies.
• Submitting a policy — contribute a policy others can discuss.