SPI Guidelines

(this document is under construction)

We need documetation on SPI:

- For everyone: Clear description of what SPI is. How to identify SPI versus API.
- For committers: When to use SPI. How to evolve SPI. How to document breaking changes.
- For clients: How to use SPI. 

See more notes in bug 193720