Background

This section covers historical context and design decisions that don't fit cleanly into a subsystem page. It's the place to look when you want to know "why" something was done a particular way.

Pages

• Design decisions -- the reasoning behind major architectural choices.
• Pitfalls and danger zones -- known gotchas, ABI traps, and historic landmines.

Related reading

• docs/ -- the in-tree documentation. Several long-form essays live here:
  • docs/Generics/ -- the Compiling Swift Generics book.
  • docs/SIL/ -- the SIL specification.
  • docs/ABI/ -- ABI / mangling / metadata layout.
  • docs/OwnershipManifesto.md, docs/StringManifesto.md, docs/LibraryEvolutionManifesto.md, docs/StringDesign.rst, docs/Lexicon.md.
• Lore -- the timeline view.
• Swift Evolution -- the proposal repository.