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