nonameplum

swift-docc

Official Swift DocC documentation markup and syntax reference

nonameplum 17 2 Updated 8mo ago
GitHub

Install

npx skillscat add nonameplum/agent-skills/swift-docc

Install via the SkillsCat registry.

About this skill

This skill enables developers to generate detailed API documentation and interactive tutorials for Swift frameworks or packages using in-source comments and supplemental content. It solves the problem of creating structured, navigable documentation directly from code, ensuring consistency and reducing manual effort. Developers should use it when building or maintaining Swift projects that require clear, integrated reference materials for users or contributors.

SKILL.md

docc

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

Documentation Structure

Essentials

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

Distribution

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.