Skip to content

Commit 6f61462

Browse files
committed
initial assessment swag
1 parent 77822b0 commit 6f61462

File tree

1 file changed

+24
-25
lines changed

1 file changed

+24
-25
lines changed

_info-architecture/0003-swift-docs-proposal.md

Lines changed: 24 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -78,9 +78,8 @@ but don't reflect all the possible future content we might create.
7878

7979
- API guidelines - moderated/reviewed by the Language Steering Group.
8080
- Server guides - moderated/reviewed by the SSWG.
81-
- Swift Migration guides - moderated by lang/platforms.
82-
- Tools Guides - moderated/reviewed by platform & ecosystem.
83-
- WASM - moderated/reviewed by platform steering group.
81+
- Ecosystem Tools Guides - moderated/reviewed by ecosystem steering group.
82+
- WASM - moderated/reviewed by ecosystem steering group.
8483

8584
An example `tree` view of such a repository:
8685

@@ -188,26 +187,26 @@ The migration can, and should, occur incrementally, building into the docs repos
188187
| `api-design-guidelines/index.md` | translate to docc, break into multiple articles in `api-guidelines/APIGuidelines.docc` |
189188
| `server/index.md` | deprecate & redirect to https://www.swift.org/get-started/cloud-services/ |
190189
| `server/guides/index.md` | translate, migrate to top level of `server-guides/ServerGuides.docc` |
191-
| `server/guides/building.md` | |
192-
| `server/guides/testing.md` | |
193-
| `server/guides/memory-leaks-and-usage.md` | |
194-
| `server/guides/allocations.md` | |
195-
| `server/guides/linux-perf.md` | |
196-
| `server/guides/performance.md` | |
197-
| `server/guides/llvm-sanitizers.md` | |
198-
| `server/guides/deployment.md` | |
199-
| `server/guides/packaging.md` | |
200-
| `server/guides/passkeys.md` | |
190+
| `server/guides/building.md` | update to swift 6 references, but otherwise migrate as is |
191+
| `server/guides/testing.md` | update to swift 6 references, but otherwise migrate as is |
192+
| `server/guides/memory-leaks-and-usage.md` | migrate as is |
193+
| `server/guides/allocations.md` | migrate as is, add reference to package-benchmark to help measure allocations |
194+
| `server/guides/linux-perf.md` | migrate as is, add reference to swift-performance-profiler, package-benchmark |
195+
| `server/guides/performance.md` | revise to reference swift-performance-profiler, package-benchmark |
196+
| `server/guides/llvm-sanitizers.md` | migrate as is |
197+
| `server/guides/packaging.md` | update content - reference Container & swift-container-plugin |
198+
| `server/guides/passkeys.md` | migrate content into article within https://github.com/swift-server/webauthn-swift.git |
201199
| `server/guides/libraries/log-levels.md` | migrate content into swift-log (https://github.com/apple/swift-log/pull/370) |
202200
| `server/guides/libraries/concurrency-adoption-guidelines.md` | deprecate and redirect to https://www.swift.org/migration/documentation/swift-6-concurrency-migration-guide/enabledataracesafety (https://github.com/swiftlang/swift-org-website/pull/1186) |
203-
| `server/guides/deploying/aws-sam-lambda.md` | |
204-
| `server/guides/deploying/aws-copilot-fargate-vapor-mongo.md` | |
205-
| `server/guides/deploying/aws.md` | |
206-
| `server/guides/deploying/digital-ocean.md` | |
207-
| `server/guides/deploying/ubuntu.md` | |
208-
| `server/guides/deploying/heroku.md` | |
209-
| `server/guides/deploying/gcp.md` | |
210-
| `articles/static-linux-getting-started.md` | |
201+
| `server/guides/deployment.md` | migrate as is - guide to deploying |
202+
| `server/guides/deploying/aws-sam-lambda.md` | migrate as is - slightly outdated |
203+
| `server/guides/deploying/aws-copilot-fargate-vapor-mongo.md` | migrate as is - slightly outdated |
204+
| `server/guides/deploying/aws.md` | migrate as is - slightly outdated |
205+
| `server/guides/deploying/digital-ocean.md` | migrate as is - slightly outdated |
206+
| `server/guides/deploying/ubuntu.md` | migrate as is - slightly outdated |
207+
| `server/guides/deploying/heroku.md` | migrate as is - slightly outdated|
208+
| `server/guides/deploying/gcp.md` | migrate as is - slightly outdated |
209+
| `articles/static-linux-getting-started.md` | migrate as is |
211210
| `migration-guide-swift3/_migration-guide.md` | migrate into https://github.com/swiftlang/swift-migration-guide |
212211
| `migration-guide-swift3/se-0107-migrate.md` | migrate into https://github.com/swiftlang/swift-migration-guide |
213212
| `migration-guide-swift3/index.md` | migrate into https://github.com/swiftlang/swift-migration-guide |
@@ -221,10 +220,10 @@ The migration can, and should, occur incrementally, building into the docs repos
221220
| `documentation/articles/zero-to-swift-nvim.md` | migrate into `ecosystem/EcosystemTools.docc` |
222221
| `documentation/articles/zero-to-swift-emacs.md` | migrate into `ecosystem/EcosystemTools.docc` |
223222
| `documentation/articles/getting-started-with-vscode-swift.md` | migrate into `ecosystem/EcosystemTools.docc` |
224-
| `articles/wasm-getting-started.md` | translate and migrate into `ecosystem |
225-
| `continuous-integration/index.md` | migrate content to github.com/swiftlang/project-operations repository |
226-
| `source-compatibility/index.md` | migrate to github.com/swiftlang/project-operations repository (referencess to swift source compatibility project) |
227-
| `source-code/index.md` | migrate to github.com/swiftlang/project-operations repository (partial list to existing source code that goes into toolchain, needs updating if kept) |
223+
| `articles/wasm-getting-started.md` | translate and migrate into `ecosystem/WASM.docc` |
224+
| `continuous-integration/index.md` | migrate content to [project-operations](https://github.com/swiftlang/project-operations) repository |
225+
| `source-compatibility/index.md` | migrate to [project-operations](https://github.com/swiftlang/project-operations) repository (referencess to swift source compatibility project) |
226+
| `source-code/index.md` | migrate to [project-operations](https://github.com/swiftlang/project-operations) repository (partial list to existing source code that goes into toolchain, needs updating if kept) |
228227

229228
### Swift.org documentation files & directories remaining:
230229

0 commit comments

Comments
 (0)