Challenge: Create amazing documentation – Discover

Swift packages icon of brown box with swift icon on it

Discover Xcode’s new documentation options and discover ways to upload documentation in your personal framework or package deal — or in your favourite open supply challenge. For this problem, we’re asking you to create documentation on your personal framework or package deal (or your favourite open supply challenge). Use Xcode 13 to construct documentation from the header feedback to your Swift framework, and upload a Documentation Catalog to prepare your content material.

Start the problem

Open up your challenge in Xcode, and get started including documentation feedback to your supply through the use of Swift DocC markdown syntax. DocC makes use of the feedback you write to your supply code because the content material for the documentation pages it generates. At a minimal, upload elementary documentation feedback to the framework’s public symbols for DocC to make use of as their unmarried-sentence abstracts or summaries. Right here’s an instance:

public struct Sloth {
    public var species: Species

If you’ve completed your documentation, choose Product > Construct Documentation to generate your supply medical doctors for Fast Lend a hand and the Developer Documentation window.

Xcode documentation window displaying information about sloths

Want assist writing or establishing your documentation? You’ll be able to proportion your growth at the Developer Boards.

Seek advice from the Apple Developer Boards


Documenting a Swift Framework or Package deal

Learn the WWDC21 Demanding situations Phrases and Stipulations

Related Articles

Leave a Reply

Your email address will not be published. Required fields are marked *

Back to top button