major README update/clarification/refresh.