mostly updated docs plus default rake task to run tests