@@ -151,10 +151,10 @@ $ swift run swift-dcov SwiftSemantics/Sources/ | jq ".data.symbols[] | select(.d
151151While there are plenty of tools for assessing test coverage for code,
152152we weren't able to find anything analogous for documentation coverage.
153153To this end,
154- we've contrived a simple JSON format
154+ we've contrived a simple JSON format
155155[inspired by llvm-cov](https://reviews.llvm.org/D22651#change-xdePaVfBugps).
156156
157- If you know of an existing standard
157+ If you know of an existing standard
158158that you think might be better suited for this purpose,
159159please reach out by [opening an Issue][open an issue]!
160160
@@ -183,7 +183,7 @@ you can feed the output of `swift-api-inventory` to conventional diffing tools
183183to determine API changes between different releases of a project.
184184
185185For example,
186- here's an API diff between the first beta and latest release candidate of
186+ here's an API diff between the first beta and latest release candidate of
187187[Alamofire 5](https://forums.swift.org/t/alamofire-5-one-year-in-the-making-now-in-beta/18865) :
188188
189189` ` ` terminal
@@ -245,7 +245,7 @@ digraph Anonymous {
245245 "URLEncodedFormEncoder" [shape=box,peripheries=2];
246246 "ServerTrustManager" [shape=box];
247247 "MultipartFormData" [shape=box];
248-
248+
249249 subgraph cluster_Request {
250250 "DataRequest" [shape=box];
251251 "Request" [shape=box];
@@ -267,13 +267,13 @@ for both Swift and Objective-C projects.
267267Over time, however,
268268the way we write Swift code —
269269and indeed the language itself —
270- has evolved to incorporate patterns and features
271- that are difficult to understand using
270+ has evolved to incorporate patterns and features
271+ that are difficult to understand using
272272the same documentation standards that served us well for Objective-C.
273273
274274Whereas in Objective-C,
275275you could get a complete view of a type's functionality from its class hierarchy,
276- Swift code today tends to layer and distribute functionality across
276+ Swift code today tends to layer and distribute functionality across
277277[a network of types][swift number protocols diagram].
278278While adopting a
279279[protocol-oriented paradigm][protocol-oriented programming]
@@ -285,7 +285,7 @@ is to make Swift documentation more useful
285285by surfacing the information you need to understand how an API works
286286and presenting it in a way that can be easily searched and accessed.
287287We want developers to be empowered to use Swift packages to their full extent,
288- without being reliant on (often outdated) blog posts or Stack Overflow threads.
288+ without being reliant on (often outdated) blog posts or Stack Overflow threads.
289289We want documentation coverage to become as important as test coverage :
290290a valuable metric for code quality,
291291and an expected part of first-rate open source projects.
@@ -334,7 +334,7 @@ Because it relies only on a syntactic reading of Swift source code,
334334without needing code first to be compiled,
335335` swift-doc` is quite fast.
336336As a baseline,
337- compare its performance to Jazzy
337+ compare its performance to Jazzy
338338when generating documentation for [SwiftSemantics][swiftsemantics] :
339339
340340` ` ` terminal
@@ -361,17 +361,19 @@ to [a GitHub wiki generated with `swift-doc`][swift-doc swiftsemantics].
361361
362362## What About [ SwiftDoc.org] [ swiftdoc.org ] ?
363363
364- ** tl;dr:**
365- We're currently working on updating SwiftDoc.org for Swift 5,
366- and hope to have it released later this week.
364+ ** tl;dr:**
365+ SwiftDoc.org is now updated for Swift 5.1,
366+ but we're still working to migrate over a few missing parts
367+ (notably, the beloved
368+ [ type inheritance graphs] ( https://swiftdoc.org/v4.2/protocol/expressiblebyfloatliteral/hierarchy/ ) ).
367369
368370SwiftDoc.org,
369371[ originally "Swifter"] ( http://natecook.com/blog/2014/09/introducing-swifter/ ) ,
370- was created by Nate Cook ([ @natecook1000 ] [ @natecook1000 ] )
372+ was created by Nate Cook ([ @natecook1000 ] [ @natecook1000 ] )
371373in September 2014.
372374At the time,
373375Swift tooling was still in its infancy,
374- so Nate actually
376+ so Nate actually
375377[ wrote a parser (from scratch!)] ( https://github.com/SwiftDocOrg/swiftdoc-parser )
376378to pull symbols and documentation from the Swift standard library.
377379Nate became managing editor of [ NSHipster] [ nshipster ] in 2015,
@@ -383,9 +385,9 @@ After the hand-off,
383385we were able to get the site updated for Swift 4.2 without too much trouble.
384386But when it came time to regenerate the site for Swift 5,
385387we found ourselves deep in [ "dependency hell"] [ dependency hell ]
386- (something to do with the [ regular expression] [ pcre ] library
388+ (something to do with the [ regular expression] [ pcre ] library
387389that Nate had used for the parser).
388- After begging and pleading with
390+ After begging and pleading with
389391the spirits possessing our ` node_modules ` directory to no avail,
390392we decided to roll up our sleeves and get started on a long-term replacement —
391393this time, written in Swift.
0 commit comments