Complete rewrite of the notes spec after feedback.