improved docs and tweaked interface