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