docs and a bit of specs