# jakarmy/swift-summary

A summary of Apple's Swift language written on Playgrounds

Repository: https://github.com/jakarmy/swift-summary
Canonical: https://ross.abutalabs.com/products/swift-summary
Language: Swift
License: MIT
License Family: permissive
Topics: swift-language, swift-summary, apple, playground, apple-documentation, xcode, playgrounds-platform, playgrounds, swift
Last push: 2021-12-27T21:10:35+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 3805, "days_push": 1710, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1662, forks 127 (observed 2026-08-28T04:05:18.606838+00:00)

## What it is
An interactive summary of Apple's Swift programming language documentation, written as a single Xcode Playground file. It condenses the main chapters of Apple's Swift book into a tinker-friendly format with Playground Markup and page linking.

## Use cases
- learn Swift quickly without reading all of Apple's docs
- interactive Swift reference I can experiment with in Playgrounds
- brush up on Swift concepts like closures, generics, and protocols
- Swift cheat sheet for experienced developers
- teach Swift basics with runnable examples

## When to choose
- you want a condensed, interactive alternative to Apple's full Swift documentation
- you learn best by tinkering with code in Xcode Playgrounds
- you need a quick refresher on Swift language fundamentals

## When to avoid
- you need up-to-date coverage of the latest Swift versions, as the content targets Swift 3.0 and hasn't been updated since 2021
- you need the omitted chapters like Strings and Characters or Nested Types
- you want a formal textbook or structured course rather than a summary

## Facets
- artifact type: learning-resource
- maturity: maintenance
- function: documentation, developer-tools
- domain: education, programming-languages, tutorials, apple-ecosystem
- platform: cross-platform
- tags: swift, playgrounds, xcode, interactive-book, apple-documentation, summary, macos

## Member repositories
- jakarmy/swift-summary (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:18.606838+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-30T03:44:34.432711+00:00, confidence not recorded.
  - readme: https://github.com/jakarmy/swift-summary (fetched 2026-08-28T04:05:18.606838+00:00, sha 732ad287a025)
- Data as of 2026-08-30T08:39:29.467469+00:00.