Skip to content

README migration guide link points to legacy URL #351

New issue
New issue
Closed
Closed
README migration guide link points to legacy URL#351
Labels
go:needs-researchNeeds investigationpriority:p2Next sprintsquadSquad triage inbox — Lead will assign to a membertype:docsDocumentation work

Description

@matthewcorven
matthewcorven
opened on Mar 11, 2026

Summary

The README currently points the migration guide reference at a legacy URL/path instead of the published docs page.

Current behavior

The migration guide link in README.md uses the repo-relative path/legacy URL:

  • docs/get-started/migration.md

On GitHub, that resolves to the repository blob view rather than the published docs site.

Expected behavior

The README should link to the published docs page:

  • https://bradygaster.github.io/squad/docs/get-started/migration/

Affected references

  • the Quick Start migration guide reference in README.md
  • the later README note about the removed GitHub-native distribution, which points at the same migration guide

Why this matters

Users reading the GitHub README should land on the published migration guide, not the source markdown/blob path.

Activity

  1. andikrueger
    added 15 commits that reference this issue on Mar 12, 2026

    fix: P0 bugs from Phase 1 testing (github#351)

    00d2713

    chore(squad): Phase 2 Wave 1 merged, Wave 2 launched

    54e4d78

    feat: rich progress indicators for agent work (github#357)

    a7170d6

    style: copy polish — human, fun, action-oriented (github#358)

    19d0e15

    feat: accessibility hardening and guidelines (github#359)

    18753ae

    feat: terminal adaptivity 40-120 col range (github#360)

    2b61df2

    feat: breathtaking first-run wow moment (github#362)

    245ad0e

    test: E2E integration tests for REPL flow (github#379)

    804ab7f

    test: human journey E2E tests - 7 real user scenarios, 39 assertions (g…

    ae4a212

    Product Love: First 10 seconds that make you want the next 10 minutes (…

    545b6e3

    fix: correct ThinkingIndicator test assertion (github#415)

    8086fec

    Fix github#422: Add context to thinking spinner (github#435)

    8e1c9f3

    Fix github#422: Add context to thinking spinner (github#436)

    41c214f

    Fix github#420/github#425: Add SDK connection feedback (github#437)

    6f8258a

    Fix github#432: Show retry warnings earlier (github#441)

    51032ac

  2. 6 remaining items

  3. github-actions commented on Mar 13, 2026

    @github-actions
    github-actionsBot
    on Mar 13, 2026 – with GitHub Actions
    Contributor

    🏗️ Squad Triage — Flight (Lead)

    Issue: #351 — README migration guide link points to legacy URL
    Assigned to: DSKY (TUI Engineer)
    Reason: Issue relates to frontend/UI work

    @copilot evaluation: No strong capability match — routed to squad member.

    Team roster:

    • Flight (Lead) → label: squad:flight
    • Procedures (Prompt Engineer) → label: squad:procedures
    • EECOM (Core Dev) → label: squad:eecom
    • FIDO (Quality Owner) → label: squad:fido
    • PAO (DevRel) → label: squad:pao
    • CAPCOM (SDK Expert) → label: squad:capcom
    • CONTROL (TypeScript Engineer) → label: squad:control
    • Surgeon (Release Manager) → label: squad:surgeon
    • Booster (CI/CD Engineer) → label: squad:booster
    • GNC (Node.js Runtime) → label: squad:gnc
    • Network (Distribution) → label: squad:network
    • RETRO (Security) → label: squad:retro
    • INCO (CLI UX & Visual Design) → label: squad:inco
    • GUIDO (VS Code Extension) → label: squad:guido
    • Telemetry (Aspire & Observability) → label: squad:telemetry
    • VOX (REPL & Interactive Shell) → label: squad:vox
    • DSKY (TUI Engineer) → label: squad:dsky
    • Sims (E2E Test Engineer) → label: squad:sims
    • Handbook (SDK Usability) → label: squad:handbook
    • Ralph (Work Monitor) → label: squad:ralph
    • @copilot (Coding Agent) → label: squad:copilot

    To reassign, remove the current squad:* label and add the correct one.

  4. github-actions
    added
    go:needs-researchNeeds investigation
    on Mar 13, 2026

  5. github-actions commented on Mar 13, 2026

    @github-actions
    github-actionsBot
    on Mar 13, 2026 – with GitHub Actions
    Contributor

    ⚠️ No squad member found matching label squad:mcmanus. Check .squad/team.md (or .ai-team/team.md) for valid member names.

  6. bradygaster
    removed
    squad:dsky
    on Mar 13, 2026

  7. bradygaster commented on Mar 13, 2026

    @bradygaster
    bradygaster
    on Mar 13, 2026
    Collaborator

    📌 Brady requested this issue be assigned to @diberry (docs/UX triage). Pending collaborator invite to complete assignment.

  8. bradygaster
    added
    squad:pao
    and removed
    squad:mcmanus
    on Mar 13, 2026

  9. github-actions commented on Mar 13, 2026

    @github-actions
    github-actionsBot
    on Mar 13, 2026 – with GitHub Actions
    Contributor

    📋 Assigned to PAO (DevRel)

    Issue: #351 — README migration guide link points to legacy URL

    PAO will pick this up in the next Copilot session.

    For Copilot coding agent: If enabled, this issue will be worked automatically.
    Otherwise, start a Copilot session and say:
    PAO, work on issue #351

  10. diberry
    added a commit that references this issue on Mar 14, 2026

    docs: fix remaining migration guide link in README - Closes github#351

    ab2a6f7

  11. diberry commented on Mar 14, 2026

    @diberry
    diberry
    on Mar 14, 2026
    Contributor

    Fix for this issue has been consolidated into PR #389 (docs: consolidated docs quality, reduction, and dedup). The original PR #395 was merged into #389. The README migration link fix is included.

  12. bradygaster commented on Mar 15, 2026

    @bradygaster
    bradygaster
    on Mar 15, 2026
    Collaborator

    Thanks for flagging this, @matthewcorven! This was fixed in PR #349 (commit a698e6a) — the migration guide link now points to the right place. Appreciate you taking the time to report it. 🙏

  13. bradygaster
    closed this as completedon Mar 15, 2026
  14. diberry
    added a commit that references this issue on Mar 15, 2026

    docs: fix remaining migration guide link in README - Closes github#351

    c221ae3
  15. bradygaster
    added a commit that references this issue on Mar 15, 2026

    docs: consolidated docs quality, reduction, and dedup

    ccb9b53
  16. bradygaster
    removed
    squad:pao
    on Sep 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    go:needs-researchNeeds investigationpriority:p2Next sprintsquadSquad triage inbox — Lead will assign to a membertype:docsDocumentation work

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions