Skip to content

Commit a5f3df1

Browse files
authored
Server related page updates (#747)
* alter server & sswg pages, hide docs from main page, new incubation-process page * add back dev guides link
1 parent bb8bf60 commit a5f3df1

File tree

4 files changed

+42
-58
lines changed

4 files changed

+42
-58
lines changed

documentation/server/index.md

Lines changed: 4 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -58,30 +58,10 @@ The Swift ecosystem contains many useful libraries and tools specifically design
5858

5959
Overall, Swift on Server opens up new opportunities for developers to build fast, scalable, and secure backend services. Swift's combination of performance, readability, interoperability, safety, and modern language features make it a compelling choice for many developers.
6060

61+
### Development guides
6162

62-
## Development guides
63+
The Swift Server Workgroup and Swift on Server community have developed a number of [guides](/documentation/server/guides/) for using Swift on the server. They are designed to help teams and individuals running Swift Server applications on Linux and to provide orientation for those who want to start with such development.
6364

64-
The Swift Server Workgroup and Swift on Server community have developed several guides for using Swift on the server.
65-
They are designed to help teams and individuals running server-side Swift applications on Linux, including orientation for those who want to start developing with Swift.
66-
67-
The following guides focus on how to compile, test, deploy, and debug applications and provide tips in those areas:
68-
69-
- [Setup and code editing](/documentation/server/guides/setup-and-ide-alternatives.html).
70-
- [Building](/documentation/server/guides/building.html).
71-
- [Testing](/documentation/server/guides/testing.html).
72-
- [Debugging Memory leaks](/documentation/server/guides/memory-leaks-and-usage.html).
73-
- [Performance troubleshooting and analysis](/documentation/server/guides/performance.html).
74-
- [Optimizing allocations](/documentation/server/guides/allocations.html).
75-
- [Debugging multithreading issues and memory checks](/documentation/server/guides/llvm-sanitizers.html).
76-
- [Deployment](/documentation/server/guides/deployment.html).
77-
- [Packaging](/documentation/server/guides/packaging.html).
78-
79-
Additionally, specific guides exist for library developers:
80-
81-
* [Log Levels](/documentation/server/guides/libraries/log-levels.html).
82-
* [Adopting Swift Concurrency](/documentation/server/guides/libraries/concurrency-adoption-guidelines.html).
83-
84-
_These guides are a community effort. Anyone is invited to share their tips and know-how by submitting pull requests to the [Swift.org site](https://github.com/swiftlang/swift-org-website)_.
8565

8666
## Swift Server Workgroup
8767

@@ -92,4 +72,5 @@ The workgroup:
9272
* Defines and runs an incubation process for these efforts to reduce duplication of effort, increase compatibility, and promote best practices.
9373
* Channels feedback for Swift language features needed by the server development community to the Swift Core Team.
9474

95-
Read more about the workgroup and server incubator it runs [here](/sswg "Swift Server Workgroup").
75+
Read more about the [workgroup](/sswg "Swift Server Workgroup") and server incubator it runs [here](/sswg/incubation-process "SSWG Incubation Process").
76+

sswg/incubated-packages.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
---
2+
layout: page
3+
title: SSWG Incubated packages
4+
---
5+
6+
The Swift Server Workgroup ([SSWG](/sswg/)) has a [process](/sswg/incubation-process/) which allows a project to go through incubation stages until it graduates and becomes a recommended project.
7+
8+
<table>
9+
<thead>
10+
<tr>
11+
<th>Project</th>
12+
<th>Description</th>
13+
<th>Maturity Level</th>
14+
<th>Pitched</th>
15+
<th>Accepted</th>
16+
</tr>
17+
</thead>
18+
<tbody>
19+
{% for project in site.data.server-workgroup.projects %}
20+
<tr>
21+
<td><a href="{{ project.url }}">{{ project.name }}</a></td>
22+
<td>{{ project.description }}</td>
23+
<td>{{ project.maturity }}</td>
24+
<td>{{ project.pitched }}</td>
25+
<td>{{ project.accepted }}</td>
26+
</tr>
27+
{% endfor %}
28+
</tbody>
29+
</table>
30+
31+
The SSWG publishes a [package collection](/blog/package-collections/) that contains the projects incubated by the workgroup. The collection is available at `https://swiftserver.group/collection/sswg.json`.
32+

sswg/incubation-process.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -200,8 +200,10 @@ Changes to the incubation process must be documented and published publicly and
200200

201201
Updates resulting in a version bump require a super-majority vote from the SSWG. Trivial changes, such as fixing typos or formatting, do not require a version bump.
202202

203+
203204
## Resources and References
204205

205-
* https://github.com/swiftlang/swift-evolution
206-
* https://github.com/cncf/toc/tree/main/process
207-
* https://incubator.apache.org
206+
- [Incubated packages](/sswg/incubated-packages)
207+
* [Swift Evolution](https://www.swift.org/swift-evolution/)
208+
* [CNCF Project Lifecycle & Process](https://github.com/cncf/toc/tree/main/process)
209+
* [The Apache Incubator](https://incubator.apache.org)

sswg/index.md

Lines changed: 1 addition & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ title: Swift Server Workgroup (SSWG)
66
The Swift Server workgroup is a steering team that promotes the use of Swift for developing and deploying server applications. The Swift Server workgroup will:
77

88
* Define and prioritize efforts that address the needs of the Swift server community.
9-
* Define and run an incubation process for these efforts to reduce duplication of effort, increase compatibility and promote best practices.
9+
* Define and run an [incubation process](/sswg/incubation-process/) for these efforts to reduce duplication of effort, increase compatibility and promote best practices.
1010
* Channel feedback for Swift language features needed by the server development community to the Swift Core Team.
1111

1212
Analogous to the [Core Team](/community#core-team) for Swift, the workgroup is responsible for providing overall technical direction and establishing the standards by which libraries and tools are proposed, developed and eventually recommended. Membership of the workgroup is contribution-based and is expected to evolve over time.
@@ -75,37 +75,6 @@ Inactive members that do not participate in four consecutive workgroup meetings
7575

7676
In various situations the SSWG shall hold a vote. These votes can happen on the phone, email, or via a voting service, when appropriate. SSWG members can either respond "agree, yes, +1", "disagree, no, -1", or "abstain". A vote passes with two-thirds vote of votes cast based on the SSWG charter. An abstain vote equals not voting at all.
7777

78-
## Incubation Process
79-
80-
The Swift Server Workgroup has a [process](/sswg/incubation-process.html) which allows a project to go through incubation stages until it graduates and becomes a recommended project.
81-
82-
## Projects
83-
84-
<table>
85-
<thead>
86-
<tr>
87-
<th>Project</th>
88-
<th>Description</th>
89-
<th>Maturity Level</th>
90-
<th>Pitched</th>
91-
<th>Accepted</th>
92-
</tr>
93-
</thead>
94-
<tbody>
95-
{% for project in site.data.server-workgroup.projects %}
96-
<tr>
97-
<td><a href="{{ project.url }}">{{ project.name }}</a></td>
98-
<td>{{ project.description }}</td>
99-
<td>{{ project.maturity }}</td>
100-
<td>{{ project.pitched }}</td>
101-
<td>{{ project.accepted }}</td>
102-
</tr>
103-
{% endfor %}
104-
</tbody>
105-
</table>
106-
107-
The SSWG publishes a [package collection](/blog/package-collections/) that contains the projects incubated by the workgroup. The collection is available at `https://swiftserver.group/collection/sswg.json`.
108-
10978
## Meeting Time
11079

11180
The SSWG meets biweekly on Wednesday at 2:00PM PT (USA Pacific). The meetings take place in the weeks with the [odd week numbers](http://www.whatweekisit.org).

0 commit comments

Comments
 (0)