Skip to content

Add the migration guide beside the architecture document - #337

Open
rnro wants to merge 1 commit into
swiftlang:mainfrom
rnro:migration-guide
Open

rnro wants to merge 1 commit into
swiftlang:mainfrom
rnro:migration-guide

Conversation

@rnro

@rnro rnro commented Oct 27, 2026

Copy link
Copy Markdown
Contributor

The architecture document describes the unified workflows but says nothing about moving a repository onto them, and the README documents only swift_package_test.yml, so a maintainer had no route from either to the inputs that were renamed, the checks that are now on by default, or the NIO workflows each call replaces.

migration.md covers a move from swift_package_test.yml and from the apple/swift-nio workflows, with the input mapping, worked examples, and the customization paths. The architecture document and the README link to it, and it links back to the architecture document for the version labels, the matrix definition and the layers.

The architecture document describes the unified workflows but says nothing about moving a repository onto them, and the README documents only `swift_package_test.yml`, so a maintainer had no route from either to the inputs that were renamed, the checks that are now on by default, or the NIO workflows each call replaces.

`migration.md` covers a move from `swift_package_test.yml` and from the `apple/swift-nio` workflows, with the input mapping, worked examples, and the customization paths. The architecture document and the README link to it, and it links back to the architecture document for the version labels, the matrix definition and the layers.
@rnro
rnro requested a review from a team as a code owner October 27, 2026 16:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant