Add comprehensive README with API docs, examples, and philosophy#1

matthewhudson wants to merge 1 commit intoava:mainava/toggles:mainfrom

matthewhudson:chore/readmematthewhudson/toggles:chore/readmeCopy head branch name to clipboard