DocSet Output

[mattt]

For Dash, and other clients.

[mattt]

To generate the database, I have a strong preference for using @stephencelis's SQLite.swift library.

[mattt]

Also, FWIW: I recently discovered Apple's docsetutil command, and am hosting a mirror of the project here (it was removed in Xcode 9.3). Unfortunately, it's unclear how Apple's .docset bundles relate to Dash's (only a few of the ones I tried from the latter validate with docsetutil), and there's no clear specification for what a DocSet bundle actually is.

[lucendio]

I guess, you are already aware of Dash-User-Contributions:Swift. If not, It might be somewhat helpful to bring the standard lib docs into Dash.

[mattt]

@lucendio Indeed I am. I believe Dash is ingesting swiftdoc.org as its primary data source for Swift standard library documentation.

[lucendio]

Not really, I think, or maybe it just used to. Examples:

• can't find the String type in Dash
• Strings and Characters does not exist in swiftdoc.org and from Dash that page links to a 404

Did swiftdoc.org derive from docs.swift.org? (I'm new to the community)

[mattt]

Not really, I think, or maybe it just used to.

Ah, my mistake. That's a recent change on the part of Dash.

Did swiftdoc.org derive from docs.swift.org? (I'm new to the community)

No, these are separate projects (although Nate and I have worked on both).

[Sam-Spencer]

Any updates on this?

[mattt]

@Sam-Spencer I was planning to ship this sooner, but #104 got away from me, and I ended up having to scrap that work. Right now, my goal is to cut a 1.0.0 release with what we have now and look at DocSet support for the next minor release (1.1.0).