wrote the spec descriptions more like a spec I'd like to read.