readme improvements for deployment