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
+23-14Lines changed: 23 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -79,32 +79,40 @@ but don't reflect all the possible future content we might create.
79
79
- API guidelines - moderated/reviewed by the Language Steering Group.
80
80
- Server guides - moderated/reviewed by the SSWG.
81
81
- Ecosystem Tools Guides - moderated/reviewed by ecosystem steering group.
82
-
-WASM - moderated/reviewed by ecosystem steering group.
82
+
-Platform Guides - moderated/reviewed by platform steering group.
83
83
84
84
An example `tree` view of such a repository:
85
85
86
86
```
87
-
├── api-guidelines
88
-
│ └── APIGuidelines.docc
89
-
│ ├── DocComment.md
90
-
│ ├── Documentation.md
91
-
│ ├── include-words-to-avoid-ambiguity.md
92
-
│ ├── name-according-to-roles.md
93
-
│ ├── omit-needless-words.md
94
-
│ └── weak-type-information.md
95
87
├── CODEOWNERS
88
+
├── common
89
+
│ ├── footer.html
90
+
│ ├── header.html
91
+
│ ├── README
92
+
│ └── theme-settings.json
96
93
├── ecosystem
97
94
│ ├── EcosystemTools.docc
98
95
│ │ ├── Documentation.md
99
96
│ │ ├── getting-started-with-vscode-swift.md
100
97
│ │ ├── zero-to-swift-emacs.md
101
98
│ │ └── zero-to-swift-nvim.md
102
-
│ └── WASM.docc
99
+
├── platform
100
+
│ └── PlatformGuides.docc
103
101
│ └── Documentation.md
104
102
├── README.md
105
-
└── server-guides
106
-
└── ServerGuides.docc
107
-
└── Documentation.md
103
+
├── server
104
+
│ └── ServerGuides.docc
105
+
│ ├── building.md
106
+
│ ├── Documentation.md
107
+
│ └── testing.md
108
+
├── swift
109
+
│ └── APIGuidelines.docc
110
+
│ ├── DocComment.md
111
+
│ ├── Documentation.md
112
+
│ ├── include-words-to-avoid-ambiguity.md
113
+
│ ├── name-according-to-roles.md
114
+
│ ├── omit-needless-words.md
115
+
│ └── weak-type-information.md
108
116
```
109
117
110
118
The directories for each catalog residing at the root can host another DocC catalog (a directory ending with .docc), to host the markdown content in a typical DocC fashion.
@@ -120,9 +128,10 @@ From a mechanical perspective, reviewers are listed in a `CODEOWNERS` file, whic
120
128
For example, the structure of the catalogs above might line up to:
0 commit comments