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](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](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](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.