Skip to content

Update unbloat-docs workflow to ignore code-generated frontmatter-full.md#2075

Merged
pelikhan merged 2 commits into
mainfrom
copilot/update-unbloat-docs-workflow
Oct 21, 2025
Merged

Update unbloat-docs workflow to ignore code-generated frontmatter-full.md#2075
pelikhan merged 2 commits into
mainfrom
copilot/update-unbloat-docs-workflow

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Oct 21, 2025

Problem

The unbloat-docs agentic workflow was not excluding the frontmatter-full.md file from its documentation cleanup process. This file is automatically generated from the JSON schema by scripts/generate-schema-docs.js (run during make agent-finish) and should not be manually edited or cleaned up by the workflow.

Solution

Updated the workflow to explicitly exclude frontmatter-full.md in two places:

1. File Discovery Command

Modified the find command to exclude the generated file:

# Before
find docs -name '*.md' -type f

# After
find docs -name '*.md' -type f ! -name 'frontmatter-full.md'

2. File Selection Criteria

Added an explicit exclusion list with documentation explaining why the file should be ignored:

**NEVER select these code-generated files**:
- `docs/src/content/docs/reference/frontmatter-full.md` - Auto-generated from JSON schema

Changes

  • Updated .github/workflows/unbloat-docs.md with exclusion logic
  • Recompiled to .github/workflows/unbloat-docs.lock.yml to reflect the changes
  • Added clear documentation explaining the exclusion to guide the AI agent

This ensures the workflow will skip the code-generated file during documentation cleanup runs, preventing conflicts with the automated schema documentation generation process.

Original prompt

Update unbloat-docs agentic workflow to ignore frontmatter-full, it is code generated.


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot AI changed the title [WIP] Update unbloat-docs workflow to ignore frontmatter-full Update unbloat-docs workflow to ignore code-generated frontmatter-full.md Oct 21, 2025
Copilot AI requested a review from pelikhan October 21, 2025 10:25
@pelikhan pelikhan marked this pull request as ready for review October 21, 2025 10:33
@github-actions
Copy link
Copy Markdown
Contributor

Agentic Changeset Generator triggered by this pull request.

@pelikhan pelikhan merged commit e6f173b into main Oct 21, 2025
7 checks passed
@pelikhan pelikhan deleted the copilot/update-unbloat-docs-workflow branch October 21, 2025 10:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants