Revert "Revert "Readme updates""

This reverts commit 364254f14327940b2d27496d9193665a7e276062.