* enhanced the brief guide for new pattern authors (thx, MM)
* made this guide an appendix
updated debugging