Migrate in-tree documentation from build repository for SHIP-0041

[adambkaplan]

Overview

This task migrates end-user documentation from the shipwright-io/build repository to the website repository as described in SHIP-0041.

Description

Identify end-user documentation in the shipwright-io/build repository, migrate relevant content to the website repository in appropriate sections (Concepts, How To, or Reference), and remove in-tree docs (replacing with links to website).

Only end-user documentation relevant to evaluators, developers, or administrators should be migrated. Contributor documentation and internal development docs should remain in the build repository.

Acceptance Criteria

• All relevant end-user docs identified in build repository
• Content migrated to appropriate website sections (Concepts, How To, or Reference)
• Hugo aliases configured for any old paths (if applicable)
• In-tree documentation removed from build repository
• Removed documentation replaced with links to website
• All links validated and working
• PR created in build repository to remove in-tree docs

Dependencies

• Blocks: Configure Hugo aliases (Issue 10)
• Blocked by: Audit and categorize existing documentation (Issue 3)

Technical Notes

• Review shipwright-io/build repository for documentation directories (typically docs/)
• Identify which documentation is end-user facing vs. contributor/internal
• Migrate content to appropriate section in website repository
• Create PR in build repository to remove migrated documentation
• Replace removed docs with README or index file that links to website
• Coordinate with build repository maintainers for review
• Contributors should feel free to create sub-issues on this task for specific content to be migrated.
  These sub-issues may be created after the audit task (Issue 3) is completed.

---

Generated-by: Cursor