They allow you to go much deeper than reference documentation or articles by giving your users a guided introduction to your framework from the ground up.Īll of these authoring experiences leverage and extend the power and simplicity of Markdown to make authoring your documentation as fluid as writing your code. And tutorials are a powerful step-by-step walk-through of writing a project that uses your framework. Articles allow you to walk users through the big picture behind your framework, giving you an opportunity to tie individual items in your framework together with a cohesive story. There are two additional ways to write documentation with DocC that we're excited to show off this year. DocC enables you to write much more than great reference documentation, though. DocC empowers you to write excellent reference documentation, leveraging the power of Xcode and Swift to give users a bird's-eye view of the public APIs in your framework or package, complete with the ability to describe how APIs work together, not just in isolation. Stay tuned for our other DocC sessions at WWDC 2021, which will go over all these in detail and much more. It's a fully integrated documentation environment that complements Xcode, offering a rich, live environment with your docs appearing in Quick Help, rich code completion to allow you to tie your docs together into a cohesive whole, full documentation available in the integrated Developer Documentation window, and an easy option to share pre-built documentation to view in Xcode and on the web, just to name a few.

Now, DocC is more than just a documentation compiler run after the fact.

We call it DocC, and we've integrated it all throughout Xcode to enhance the way you read and write documentation. Now Xcode comes with a compiler for your documentation as well as your code, and you can build and view documentation for Swift frameworks and packages all inside Xcode. There's some new framework or package that we want to use, but when it comes time to integrate it into our code, we need to figure out what all comes in it. Let's get started with why I'm personally excited about the new documentation features. In this session, we'll give an overview of the documentation features in Xcode 13, walk you through building documentation for the Swift frameworks and packages you're writing and using, show you how you can use Xcode 13 to write great documentation, and finish up by showing off the ways you can share documentation with Xcode 13. This documentation lives right alongside the platform libraries in the Developer Documentation window right in Xcode. This unlocks a powerful mode of documentation-driven development where you can read all about your Swift dependencies while you write your code. Xcode 13 has new features to build, write, and browse documentation for Swift frameworks and packages.

There are new ways to read and write documentation that both fit right into your workflow and unlock new possibilities for your development. I'm an engineer on the Documentation Tools team here at Apple, and together with my colleague Ethan, we're going to give you an introduction to the new documentation features in Xcode 13.

Documentation xcode