Skip to content

Update dictation workflow to scan user-facing documentation and exclude tooling terms#2155

Merged
pelikhan merged 2 commits intomainfrom
copilot/update-dictation-agentic-workflow
Oct 22, 2025
Merged

Update dictation workflow to scan user-facing documentation and exclude tooling terms#2155
pelikhan merged 2 commits intomainfrom
copilot/update-dictation-agentic-workflow

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Oct 22, 2025

Problem

The dictation prompt generator workflow was scanning all markdown files under docs/ and including tooling-specific terms that aren't user-facing concepts. This resulted in glossary terms like "makefile", "Astro", and "starlight" that are irrelevant to users creating agentic workflows.

Solution

Updated the workflow to focus on user-facing documentation:

  1. Changed documentation scan path from docs/**/*.md to docs/src/content/docs/**/*.md to target only the published documentation content
  2. Removed tooling-specific terms from the existing glossary (makefile, starlight)
  3. Added explicit exclusion guidelines in the workflow instructions to prevent these terms from being re-added

Changes

.github/workflows/dictation-prompt.md

  • Updated all bash commands to scan docs/src/content/docs/**/*.md
  • Removed reference to docs/README.md (build instructions, not user docs)
  • Added exclusion note: "Do not include makefile, Astro, or starlight as these are tooling-specific and not user-facing concepts"
  • Updated success criteria to reflect the new documentation path

.github/instructions/dictation.instructions.md

  • Removed "makefile" from the project glossary
  • Removed "starlight" from the project glossary
  • Glossary now contains 119 user-facing terms

Impact

The dictation workflow will now generate a glossary focused exclusively on terms that users encounter when working with agentic workflows, improving the accuracy of speech-to-text rephrasing for workflow creation.

Original prompt

Update dictation agentic workflow

  • ignore makefile, Astro, starlight as they are tooling specific and not user facing
  • scan markdown files under docs/src/content/docs/**.md

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

…ooling terms

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot AI changed the title [WIP] Update dictation agentic workflow for markdown scanning Update dictation workflow to scan user-facing documentation and exclude tooling terms Oct 22, 2025
Copilot AI requested a review from pelikhan October 22, 2025 19:50
@pelikhan pelikhan marked this pull request as ready for review October 22, 2025 19:55
@pelikhan pelikhan merged commit de77a04 into main Oct 22, 2025
4 checks passed
@pelikhan pelikhan deleted the copilot/update-dictation-agentic-workflow branch October 22, 2025 19:55
@github-actions
Copy link
Copy Markdown
Contributor

Agentic Changeset Generator triggered by this pull request.

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