Add docs.yml workflow for GitHub Pages deployment

[Copilot]

Adds a docs.yml workflow to enable pmndrs/docs to deploy its own documentation to GitHub Pages, following the pattern established by other pmndrs repositories like react-three-fiber.

Changes

• .github/workflows/docs.yml: New workflow that builds and deploys docs on push to main

  • Calls reusable pmndrs/docs/.github/workflows/build.yml@v2 with Poimandres branding
  • Explicit GITHUB_TOKEN permissions for security (contents: read, pages: write, id-token: write)
  • Deploys to github-pages environment via actions/deploy-pages@v4

• .changeset/cyan-dancers-ring.md: Major version bump for the new workflow capability

Configuration

build:
  permissions:
    contents: read
    pages: write
    id-token: write
  uses: pmndrs/docs/.github/workflows/build.yml@v2
  with:
    mdx: 'docs'
    libname: 'Poimandres'
    home_redirect: '/getting-started/introduction'
    logo: 'gutenberg.jpg'

Original prompt

i want pmndrs/docs uses its own .github/workflows/docs.yml as eg. https://github.com/pmndrs/react-three-fiber/blob/master/.github/workflows/docs.yml as well

---

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