specs, help, docs and general improvements