document the differences between generic and default controller and explain enhancer priorities

| Q             | A
| ------------- | ---
| Doc fix?      | yes
| New docs?     | yes
| Applies to    | all
| Fixed tickets | #306 

also happens to contain quite a bit of doc improvements for ContentBundle.