...

All Model Properties that are not $refs should have an example value specified.

Local Definitions

The API specification should not have local definitions (i.e. only $refs are allowed)

That is, APIs should not have the definitions section (even if these local definitions are not used). Instead, schemas should be kept in domains and referenced using domain references.

A domain is a library of common components – such as parameters, responses and data models – that are used across multiple API definitions

Naming Conventions

URL Construction

...