Document some gotchas in z3c.form

This document is already huge, but then again z3c.form is huge too :-(