Ethan KustersSome truly game-changing improvements to Swift-DocC documentation are available in an Xcode 15 beta near you. Some highlights are in the thread below, but check out the "Create rich documentation with Swift-DocC" session to learn more. 🧵
Documentation Preview provides a side-by-side preview of your rendered documentation – updating in real-time as you type.
Check it out by activating Xcode's assistant editor via Editor > Assistant, and then selecting “Documentation Preview” in the jump bar.
Documentation built with Xcode 15 now includes pages for Swift extensions to external modules.
The underlying support for this feature was driven by
@_maxobermeier in the Swift open-source community. So exciting to see it ship as enabled by default in Xcode 15 and Swift 5.9.
Swift-DocC websites now include a quick navigation feature that allows you to jump directly to a page just by typing its name.
Shout-out to Sofía Rodríguez (https://twitter.com/sofiaromorales) who drove the original version of this feature as a GSoC project. 🥳
(Pro-tip: Try pressing Shift+Cmd+O on http://developer.apple.com/documentation)
Swift-DocC now supports designing pages with fully custom layouts by utilizing new directives like Row/Column, TabNavigator, PageImage, and Video.
Check out the documentation (and the session) to learn more: https://developer.apple.com/documentation/docc/api-reference-syntax#configuring-documentation-behavior
I'd love to know what you think! And, of course, don't forget to watch the session and sign up for Wednesday's documentation lab (linked below the session video) to learn more.
Matt Massicotte@kusters @_maxobermeier so pumped for this one. Just wonderful stuff!
Max Obermeier@kusters Wow, so cool to see this featured at WWDC! I’m looking forward to trying all the other cool features added this year. Loved your presentation Ethan!