This is an unofficial copy of the Swift internals documentation, that may have been modified. The official version of this page, if it exists, would be found here.

API Design Guidelines

To facilitate use as a quick reference, the details of many guidelines can be expanded individually. Details are never hidden when this page is printed.

Table of Contents



Promote Clear Usage

Strive for Fluent Usage

Use Terminology Well

Term of Art
noun - a word or phrase that has a precise, specialized meaning within a particular field or profession.


General Conventions


func move(from **start**: Point, to **end**: Point)

Argument Labels

func move(**from** start: Point, **to** end: Point)
x.move(**from:** x, **to:** y) 

Special Instructions