Merge pull request #37 from elliot42/master

Clarify design note