PROBLEM
The symfony Forms Book (page 1) lacks troubleshooting suggestions (like those found on The Definitive Guide to symfony (page 2)) like suggesting the user clear their cache directory when attempting to execute the form generator but receive Fatal error: Class 'ContactForm' no ..... This is a problem because the former is a "step-by-step" guide while the latter is not; but an in-depth look at symfony.
I am at least the 2nd person to have this exact cache directory issue. The other: symfony Forum Thread. The post is immediately replied to within a couple hours. And the reply is a 1 liner at that. This tells me that clearing the cache directory might be common knowledge... meanwhile I spent 2+ hours trying to figure it out.
RESOLUTION
- Provide a troubleshooting step/note suggesting to reader to clear their cache right before the "Figure 1-4 - Generated Contact Form" at symfony Forms Book (page 1).
- OR aggregate all troubleshooting steps to the end of the page, like what was done on http://www.symfony-project.org/book/1_1/03-Running-Symfony.
- OR have a single page, itemizing known troubleshooting techniques and link to this page, where beneficial, site wide.
