You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: _info-architecture/0003-swift-docs-proposal.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -188,9 +188,9 @@ Files under the `documentation` directory on Swift.org:
188
188
|[`server/guides/index.md`](https://www.swift.org/documentation/server/guides/index.html)| translate, migrate to top level of `server-guides/ServerGuides.docc`|
189
189
|[`server/guides/building.md`](https://www.swift.org/documentation/server/guides/building.html)| refine/update to provide examples of building, add section for debug vs. release and swift tooling, link to SwiftPM docs on building, add section about building in Linux using containers, add section on building with devContainers, add detail on static linux SDK, break out some content to a CI related article |
190
190
|[`server/guides/testing.md`](https://www.swift.org/documentation/server/guides/testing.html)| heavily outdated - update to swift 6, swift-testing, break out some content into a "CI" focused article - focus on unit testing, leave room for functional, integration testing as sep articles |
191
-
|[`server/guides/memory-leaks-and-usage.md`](https://www.swift.org/documentation/server/guides/memory-leaks-and-usage.html)| migrate as is |
192
-
|[`server/guides/allocations.md`](https://www.swift.org/documentation/server/guides/allocations.html)| migrate as is, add reference to package-benchmark to help measure allocations |
193
-
|[`server/guides/linux-perf.md`](https://www.swift.org/documentation/server/guides/linux-perf.html)| migrate as is, update examples to use container and latest versions, break out a separate flame-graph article |
191
+
|[`server/guides/memory-leaks-and-usage.md`](https://www.swift.org/documentation/server/guides/memory-leaks-and-usage.html)| migrate as is - verify guides still work. Consider breaking into multiple smaller articles. |
192
+
|[`server/guides/allocations.md`](https://www.swift.org/documentation/server/guides/allocations.html)| migrate as is, add reference to package-benchmark to help measure allocations, verify content is still current with subject matter experts|
193
+
|[`server/guides/linux-perf.md`](https://www.swift.org/documentation/server/guides/linux-perf.html)| migrate as is, update examples to use container and latest versions, break out a separate flame-graph article, verify content is still current with subject matter experts|
194
194
|[`server/guides/performance.md`](https://www.swift.org/documentation/server/guides/performance.html)| revise to guidepints for understand performance, reference swift-performance-profiler, package-benchmark, break out flamegraph (what they are, how to read) into it's own article - include perf profiler flamegraphs tool references |
195
195
|[`server/guides/llvm-sanitizers.md`](https://www.swift.org/documentation/server/guides/llvm-sanitizers.html)| merge content into 'build' and 'test' articles, deprecate/remove |
196
196
|[`server/guides/packaging.md`](https://www.swift.org/documentation/server/guides/packaging.html)| add new overview of options, incl static-binary, container. reference runtime dependencies with static compilation options, example of docker w/ 2-stage build and using published docker binaries, break out distroless into it's own article |
@@ -205,7 +205,7 @@ Files under the `documentation` directory on Swift.org:
205
205
|[`server/guides/deploying/ubuntu.md`](https://www.swift.org/documentation/server/guides/deploying/ubuntu.html)| migrate as is - slightly outdated |
206
206
|[`server/guides/deploying/heroku.md`](https://www.swift.org/documentation/server/guides/deploying/heroku.html)| migrate as is - slightly outdated|
207
207
|[`server/guides/deploying/gcp.md`](https://www.swift.org/documentation/server/guides/deploying/gcp.html)| migrate as is - slightly outdated |
208
-
|[`articles/static-linux-getting-started.md`](https://www.swift.org/documentation/articles/static-linux-getting-started.html)| migrate as is |
208
+
|[`articles/static-linux-getting-started.md`](https://www.swift.org/documentation/articles/static-linux-getting-started.html)| migrate as is - consider renaming or breaking into multiple, smaller focused articles, review any changes with previous authors (Alastair, Melissa) |
209
209
|`migration-guide-swift3/_migration-guide.md`| migrate into https://github.com/swiftlang/swift-migration-guide|
210
210
|`migration-guide-swift3/se-0107-migrate.md`| migrate into https://github.com/swiftlang/swift-migration-guide|
211
211
|[`migration-guide-swift3/index.md`](https://www.swift.org/migration-guide-swift3/index.html)| migrate into https://github.com/swiftlang/swift-migration-guide|
0 commit comments