Skip to content

docs(security): add frontmatter to the #3524 fail-open audit note - #3619

Merged
liamcrumm merged 2 commits into
microsoft:mainfrom
chopmob-cloud:fix/frontmatter-fail-open-audit-doc
Aug 12, 2026
Merged

liamcrumm merged 2 commits into
microsoft:mainfrom
chopmob-cloud:fix/frontmatter-fail-open-audit-doc

Conversation

@chopmob-cloud

Copy link
Copy Markdown
Contributor

Problem

The strict docs-frontmatter gate added in #3352 scans the whole tree (check_frontmatter.py --root . --strict). The fail-open closure audit doc merged in #3524 (docs/security/audits/2026-07-31-fail-open-closure-python-reference.md) has no frontmatter block, so main fails its own gate, and every open PR rebased onto current main inherits the "Validate docs frontmatter" failure.

Fix

Add the title / last_reviewed / owner frontmatter block, matching the sibling audit docs under docs/security/audits/.

Validation

$ python scripts/docs/check_frontmatter.py --root . --strict
Scanned 279 file(s), 0 finding(s).

Content below the header is unchanged.

… note

The 2026-07-31 fail-open closure audit doc merged in microsoft#3524 without a
frontmatter block, but the strict frontmatter gate added in microsoft#3352 scans
the whole tree (--root .). main therefore fails its own gate, and every
open PR rebased onto main inherits the failure.

Add the title/last_reviewed/owner block matching the sibling audit docs
so `check_frontmatter.py --root . --strict` reports 0 findings.

Signed-off-by: AlgoVoi <chopmob@gmail.com>
Copilot AI lite review requested due to automatic review settings August 4, 2026 22:41
@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines:
There may be pipelines that require an authorized user to comment /azp run to run.

@github-actions github-actions Bot added documentation Improvements or additions to documentation security Security-related issues size/XS Extra small PR (< 10 lines) labels Aug 4, 2026
@github-actions

github-actions Bot commented Aug 4, 2026

Copy link
Copy Markdown

PR Review Summary

Check Status Details
🔍 Code Review ⚠️ Missing No current-run comment
🛡️ Security Scan ⚠️ Missing No current-run comment
🔄 Breaking Changes ⚠️ Missing No current-run comment
📝 Docs Sync ⚠️ Missing No current-run comment
🧪 Test Coverage ⚠️ Missing No current-run comment

Verdict: ⚠️ AI review incomplete; ready for human review

AI review comments are untrusted advisory output. The summary reports workflow-generated completion status only, not model-authored pass/fail claims.

@github-actions

github-actions Bot commented Aug 4, 2026

Copy link
Copy Markdown

🔴 Contributor Check: HIGH

Check Result
Profile HIGH
Credential LOW
Overall HIGH

Automated check by AGT Contributor Check.

@github-actions github-actions Bot added the needs-review:HIGH Contributor reputation check flagged HIGH risk label Aug 4, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR restores the repository’s docs frontmatter invariant by adding the required YAML frontmatter block to the 2026-07-31 security audit note, unblocking the strict check_frontmatter.py --root . --strict CI gate that scans the full docs/ tree.

TL;DR: 0 blockers, 0 warnings. No issues found. Clean change.

Changes:

  • Adds required docs YAML frontmatter (title, last_reviewed, owner) to the affected audit doc.
  • Leaves the audit content unchanged beyond the metadata header.

Copilot AI review requested due to automatic review settings August 6, 2026 18:29

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

@liamcrumm

Copy link
Copy Markdown
Contributor

it seems the workflows didn't kick off for this pr. I will close/reopen to retrigger workflows

@liamcrumm liamcrumm closed this Aug 12, 2026
@liamcrumm liamcrumm reopened this Aug 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation needs-review:HIGH Contributor reputation check flagged HIGH risk security Security-related issues size/XS Extra small PR (< 10 lines)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants