Improve readme

@charlierudolph @allewun 
Maybe call this section "Design decisions" or something like that? "Notes" seems a bit vague