V1 of the spec

Work in progress. Note: spell check was off.