Skip to content

Normalize shared reporting guidance to enforce h3+ headings and progressive disclosure#47089

Draft
pelikhan with Copilot wants to merge 3 commits into
mainfrom
copilot/workflow-style-normalize-report-formatting-eab0a332-4bfd-4e42-abbb-c1b87ec2e5b8
Draft

Normalize shared reporting guidance to enforce h3+ headings and progressive disclosure#47089
pelikhan with Copilot wants to merge 3 commits into
mainfrom
copilot/workflow-style-normalize-report-formatting-eab0a332-4bfd-4e42-abbb-c1b87ec2e5b8

Conversation

Copilot AI commented Jul 21, 2026

Copy link
Copy Markdown
Contributor

A workflow-style audit found broad non-compliance in report output instructions: many workflows still used #/## headings and inconsistent guidance for collapsible detail sections. This change standardizes the shared reporting contract so importing workflows inherit compliant structure and formatting.

  • Shared reporting contract update

    • Updated .github/workflows/shared/reporting.md to use ###-level section headings (or lower) in report instructions.
    • Kept report structure explicit: overview → key metrics/issues → collapsible detail → next actions.
    • Added concrete long-section guidance for lists/tables (>5 items) using <details> with bold summary text.
  • Frontmatter correctness

    • Fixed frontmatter/content boundary in shared/reporting.md so the document remains valid and compiles cleanly.
  • Compiled workflow sync

    • Regenerated affected .lock.yml files for workflows importing shared reporting guidance to keep compiled artifacts aligned with source instructions.
### Report structure guidelines

- Use `###` (or lower) headers only.
- For long lists/tables (>5 items), use:
  <details>
  <summary><b>View Details</b></summary>

  - item 1
  - item 2

  </details>

Copilot AI and others added 2 commits July 21, 2026 14:01
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot AI changed the title [WIP] Normalize report formatting for non-compliant workflows Normalize shared reporting guidance to enforce h3+ headings and progressive disclosure Jul 21, 2026
Copilot AI requested a review from pelikhan July 21, 2026 14:21
@github-actions

Copy link
Copy Markdown
Contributor

🤖 PR Triage

Field Value
Category formatting
Risk medium
Score 33 / 100
Action batch_review
Batch pr-batch:workflow-formatting

Score breakdown: Impact 15 · Urgency 8 · Quality 10

Draft PR normalizing report formatting (h3+ headings) across 40+ workflow lock files + shared/reporting.md. Medium risk due to volume of lock file changes. No CI data. Batch with workflow changes (see #47107).

Generated by 🔧 PR Triage Agent · sonnet46 43.3 AIC · ⌖ 5.33 AIC · ⊞ 5.6K ·

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[workflow-style] Normalize report formatting for non-compliant workflows

2 participants