[swift-dev] Extracting documentation from stdlib

[George King]

Hi list,

After a bit of poking around I do not see how to extract/build the api docs from the stdlib source code. Is this functionality part of the open source release?

I am asking because the new Xcode 8 documentation viewer is very frustrating; everything is broken up into separate pages which makes browsing difficult, and the page css makes the windows artificially narrow, so reading declarations requires horizontal scrolling; as an example, look at the doc page for `zip(_:_:)`. On top of that, we used to be able to click through on a symbol and see the stdlib pseudo-header in its entirety; in xc 8 it appears to be broken up into a bunch of sections which are lazily loaded, which prevents me from looking for things whose names have changed in the migration.

Anyway, I realize that this is may not be the right forum to complain about Xcode, but as an open source community, we ought to have other options for looking at the docs!

Thanks in advance,
-George