added .clear-* documentation to design guide
Merge pull request #1234 from cfarquharson/master

added .clear-* documentation to design guide