update Rakefile for testing with dummy app
update docs and warn about breaking changes