Improvements of README documentation

@balhoff go ahead and merge at your discretion.