update doc README to include suggestions from weekly meeting