moar docs and specs; release ready