some extra notes (resolves #50)