some commenting and minor readme changes