rewrite apiary specification

* much more detailed now
* using new api blueprint
* nowhere near done