edit readme
adding some doc blocks
fix bitbucket post