Skip to content

Automate Surge previews for documentation PRs #18

Description

@paolino

Add the documentation-skill Surge preview workflow so every PR gets a stable static-docs preview URL without waiting for GitHub Pages deployment on main.

Acceptance criteria

  • Add a PR preview workflow that runs on pull requests to main.
  • Build the MkDocs site with mkdocs build --strict.
  • Deploy to https://lambdasistemi-amaru-bootstrap-pr-${{ github.event.number }}.surge.sh using SURGE_TOKEN.
  • Upsert a PR comment marked with <!-- surge-preview-url --> instead of posting a new comment on every push.
  • Document the one-time secret setup: gh secret set SURGE_TOKEN --repo lambdasistemi/amaru-bootstrap --body "<token>".
  • Keep GitHub Pages deployment on main unchanged.

Context

Metadata

Metadata

Assignees

No one assigned

    Labels

    ciCI/CD changesdocumentationImprovements or additions to documentation

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions