# Standard Library Programmers Manual

This is meant to be a guide to people working on the standard library. It covers coding standards, code organization, best practices, internal annotations, and provides a guide to standard library internals. This document is inspired by LLVM's excellent [programmer's manual](http://llvm.org/docs/ProgrammersManual.html) and [coding standards](http://llvm.org/docs/CodingStandards.html).

TBD: Should this subsume [StdlibRationales.rst](https://github.com/apple/swift/blob/master/docs/StdlibRationales.rst)?

## Library Organization

TBD

### Stubs

TBD

## Protocols and Classes

TBD

### Customization Hooks

TBD

## Internals

### Annotations

TBD

### Versioning and Compatibility

TBD

## Coding Standards

TBD