✨ Set up Copilot instructions

[Copilot]

Adds Copilot coding agent instructions per GitHub best practices to provide repository context and development workflows.

Changes

• Created .github/copilot-instructions.md with:
  • docfx-centric guidance: Build process, Markdown authoring conventions, API Browser metadata generation
  • Repository structure: Content organization (/docs, /articles, /guides), versioning (v2/v3/v4), template customization
  • Development workflows: Quick start (dotnet run), full builds (build-metadata.ps1), clean builds
  • Content creation: Blog post and documentation page templates with YAML front matter requirements
  • Configuration details: docfx.json variants, toc.yml management, link validation, YAML display options

Key Sections

• Technology stack and dependencies (ASP.NET Core Blazor, docfx, PowerShell)
• Build commands for local development vs. full API documentation generation
• docfx Flavored Markdown guidelines and cross-reference syntax
• Common tasks (updating API docs, adding new Steeltoe versions, template modifications)
• Best practices for surgical changes and link validation

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:

• gh.io
  • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node /home/REDACTED/work/_temp/ghcca-node/node/bin/node --enable-source-maps /home/REDACTED/work/_temp/copilot-developer-action-main/dist/index.js (dns block)

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

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

---

This section details on the original issue you should resolve

<issue_title>✨ Set up Copilot instructions</issue_title>
<issue_description>Configure instructions for this repository as documented in Best practices for Copilot coding agent in your repository.

</issue_description>

<agent_instructions>This repo is heavily dependent on docfx</agent_instructions>

Comments on the Issue (you are @copilot in this section)

• Fixes ✨ Set up Copilot instructions #425

---

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