major touchup of readme. improved many examples and explanations