fixes for pending release
README finally written