# swiftlang/swift-docc

Documentation compiler that produces rich API reference documentation and interactive tutorials for your Swift framework or package.

Repository: https://github.com/swiftlang/swift-docc
Canonical: https://ross.abutalabs.com/products/swift-docc
Homepage: https://swift.org/documentation/docc
Language: Swift
License: Apache-2.0
License Family: permissive
Last push: 2026-08-26T09:55:59+00:00

## Health v2 (maintenance only)
Score: 96/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 99, release rhythm 91, longevity 100
- inputs: {"age_days": 1871, "days_push": 7, "days_rel": 62, "gap_med": 0, "n_releases_24m": 26}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1364, forks 183 (observed 2026-08-28T04:04:30.973507+00:00)

## What it is
Swift-DocC is a documentation compiler for Swift frameworks and packages that generates rich API reference documentation and interactive tutorials. It is the tool behind Apple's developer documentation and integrates with SwiftPM, Xcode, and the command line.

## Use cases
- generate api reference docs for my swift package
- publish swift framework documentation to a website or github pages
- write interactive tutorials for my swift library
- preview documentation locally while writing doc comments
- build documentation in ci for a swift project

## When to choose
- you develop Swift frameworks, packages, or apps and want idiomatic Apple-style docs
- you want API reference and tutorial content generated from source comments
- you use SwiftPM or Xcode and want integrated documentation builds

## When to avoid
- your project is not in Swift
- you need docs for languages or ecosystems DocC does not support
- you need highly custom static site layouts outside DocC's rendering model

## Facets
- artifact type: cli-tool
- maturity: active
- function: documentation, cli, static-site-generator
- domain: documentation, developer-tools, apple-ecosystem
- platform: cli
- tags: swift, docc, api-reference, tutorials, swiftpm, apple, macos, linux

## Member repositories
- swiftlang/swift-docc (main) score 96

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:30.973507+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:41:22.643867+00:00, confidence not recorded.
  - readme: https://github.com/swiftlang/swift-docc (fetched 2026-08-28T04:04:30.973507+00:00, sha 6718866f053e)
  - homepage: https://swift.org/documentation/docc (fetched 2026-08-29T11:58:46.823550+00:00, sha 123faf0a4fb2)
- Data as of 2026-08-30T08:39:29.467469+00:00.