name: swift-docc
description: Official Swift DocC documentation markup and syntax reference

docc

Produce rich API reference documentation and interactive tutorials for your Swift framework or package.

Documentation Structure

Essentials

• Documenting a Swift Framework or Package (documenting-a-swift-framework-or-package.md): Create developer documentation from in-source comments, add articles with code snippets,

Documentation Content

• Writing Symbol Documentation in Your Source Files (writing-symbol-documentation-in-your-source-files.md): Add reference documentation to your symbols that explains how to use them.
• Adding Supplemental Content to a Documentation Catalog (adding-supplemental-content-to-a-documentation-catalog.md): Include articles and extension files to extend your source documentation comments or provide supporting conceptual content.
• Linking to Symbols and Other Content (linking-to-symbols-and-other-content.md): Facilitate navigation between pages using links.
• Adding Code Snippets to your Content (adding-code-snippets-to-your-content.md): Create and include code snippets to illustrate and provide examples of how to use your API.
• Documenting API with Different Language Representations (Documenting API with different language representations/documenting-api-with-different-language-representations.md): Create documentation for API that's callable from more than one source language.

Structure and Formatting

• Formatting Your Documentation Content (formatting-your-documentation-content.md): Enhance your content's presentation with special formatting and styling for text and lists.
• Adding Tables of Data (adding-tables-of-data.md): Arrange information into rows and columns.
• Other Formatting Options (other-formatting-options.md): Improve the presentation and structure of your content by incorporating special page elements.
• Adding Images to Your Content (adding-images.md): Elevate your content's visual appeal by adding images.
• Adding Structure to Your Documentation Pages (adding-structure-to-your-documentation-pages.md): Make symbols easier to find by arranging them into groups and collections.
• Customizing the Appearance of Your Documentation Pages (customizing-the-appearance-of-your-documentation-pages.md): Customize the look and feel of your documentation webpages.

Distribution

• Distributing Documentation to Other Developers (distributing-documentation-to-other-developers.md): Share your documentation by hosting it on a web server.

Documentation Types

• API Documentation (Reference Syntax/API Reference Syntax/api-reference-syntax.md): Teach your APIs through reference documentation you create from code comments and extension files, or create detailed articles and conceptual guides.
• Interactive Tutorials (Reference Syntax/Tutorials Syntax/tutorial-syntax.md): Teach developers your Swift APIs through step-by-step, interactive content.

Shared Syntax

Usage Notes

• Documentation is organized progressively from getting started to advanced topics
• Start with the Introduction or Getting Started section
• Consult specific guides for detailed information

License & Attribution

This skill contains content converted from DocC documentation format.