Skip to content

Add Dictating Agentic Workflows section to authoring documentation - #2154

Merged
pelikhan merged 3 commits into
mainfrom
copilot/update-agentic-authoring-docs
Oct 22, 2025
Merged

pelikhan merged 3 commits into
mainfrom
copilot/update-agentic-authoring-docs

Conversation

Copilot AI commented Oct 22, 2025 •

Copy link
Copy Markdown
Contributor

Overview

Added a new "Dictating Agentic Workflows" section to the agentic authoring documentation page that provides guidance for users who want to create workflows using speech-to-text dictation.

Changes

The new section includes:

  • Direct link to dictation instructions: Provides a link to the raw GitHub URL of the dictation.instructions.md file at https://raw.githubusercontent.com/githubnext/gh-aw/main/.github/instructions/dictation.instructions.md

  • Clear explanation: Describes how the prompt helps correct common text-to-speech issues like terminology mismatches and formatting problems

  • Detailed benefits: Lists specific ways the prompt improves dictated content:

    • Correcting project-specific terminology (e.g., "ghaw" → "gh-aw", "work flow" → "workflow")
    • Transforming casual dictated sentences into clear, imperative task descriptions
    • Removing filler words and improving technical tone
    • Adding necessary context that might be implicit in spoken requests
  • Usage guidance: Instructions on when and how to load the dictation prompt with AI assistants

Location

The section is positioned logically between "Other Agents and chats" and "After compiling" sections in /docs/src/content/docs/tools/agentic-authoring.md.

Screenshot

Dictating Agentic Workflows Section

The new section appears in the table of contents and integrates seamlessly with the existing documentation style.

Validation

  • ✅ Documentation builds successfully without errors
  • ✅ All internal links validated
  • ✅ All unit tests pass
  • ✅ Visual verification confirms proper rendering

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

  • telemetry.astro.build
    • Triggering command: node /home/REDACTED/work/gh-aw/gh-aw/docs/node_modules/.bin/astro build (dns block)
    • Triggering command: node /home/REDACTED/work/gh-aw/gh-aw/docs/node_modules/.bin/astro preview --port 4321 (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

Original prompt

Update the agentic authoring documentation page with a link to the raw url to the dictation.instructions.md file. Add explanation that this prompt is meant to help correct text captured with text-to-speech. "Dictating Agentic Worflows"


💡 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.

@pelikhan

Copy link
Copy Markdown
Collaborator

@copilot Add a "Copy To Clipboard" button component for the Astro Starlight documentation that takes a URL and a download name. Place button next to the URL.

Copilot AI and others added 2 commits October 22, 2025 19:44
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] Update agentic authoring documentation with dictation link Add Dictating Agentic Workflows section to authoring documentation Oct 22, 2025
Copilot AI requested a review from pelikhan October 22, 2025 19:52
Copilot stopped work on behalf of pelikhan due to an error October 22, 2025 19:52
@pelikhan
pelikhan marked this pull request as ready for review October 22, 2025 19:54
@pelikhan
pelikhan merged commit 7f8fc9f into main Oct 22, 2025
@pelikhan
pelikhan deleted the copilot/update-agentic-authoring-docs branch October 22, 2025 19:54
@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