Comment by ds_

Documentation (and press releases/FAQs) are usually for users. Specifications are for developers. The former can precede and help with forming the latter.