The useful change is record custody.
On October 2, GitHub added confidential comments to repository security advisories. A maintainer can select "Confidential. Only maintainers will see this comment" before posting. People with write access can see the comment. Reporters and invited collaborators without write access cannot see it and do not receive a notification.[1]
The practical win is not secrecy by itself. It is continuity. GitHub says teams previously moved abuse concerns, investigation details, and coordination notes into another system. The advisory then lost part of its own history. A confidential comment keeps that note beside the report, patch work, and eventual publication.
A private note is useful when it preserves the case record. It is dangerous when it hides the case decision.
Visibility follows current write access.
The audience is permission-based, not a hand-picked list. GitHub says current repository write access controls visibility. If a person loses write access, that person can no longer read confidential comments. Views appear in the audit log.[1]
That makes each comment a live access-control decision. Before posting, name why the reporter should not see it. Check who currently has write access. Do not assume that yesterday's maintainer roster still defines today's audience.
The control is also one-way. GitHub says a posted comment cannot switch between regular and confidential. If you choose the wrong lane, a later toggle cannot repair the audience decision. Read the text and recipient class before posting.
The API paths do not match.
GitHub says confidential comments are available through GraphQL but are not returned by the REST API.[1] Any bot that mirrors advisory activity needs an explicit test for this difference. A successful REST export is not proof that the full maintainer record was copied.
Record which interface produced an archive. If a retention or incident-review process needs confidential comments, test the GraphQL query with an account that has the required access. Then verify the export against a known confidential marker. Do not log real vulnerability details in a test fixture.
Keep coordinated disclosure shared.
GitHub's advisory documentation describes a longer job. Maintainers discuss impact, collaborate on a fix in a temporary private fork, and publish the advisory after a patch is released. It recommends adding a fix version before publication when possible.[2]
The OpenSSF finder guide describes coordinated vulnerability disclosure as private reporting, fix creation and testing, then disclosure to downstream users with the mitigation ready. It also tells reporters to state disclosure timing and constraints early.[3]
A confidential maintainer comment does not complete any of those steps. Use it for material that would harm the investigation or expose someone. Put requests to the reporter, reproducible findings they need to answer, expected dates, fix status, and credit decisions in the shared record unless there is a specific reason not to.