By chris55 on
Am I alone in being irritated by "descriptions" of capabilities such as the following:
- Description
- The Drupal forms API is a powerful leap forward. It also allows for almost unlimited possibilities for custom theming, validation, and execution of forms. Even better, ANY form (even those in core) can be altered in almost any way imaginable--elements can be removed, added, and rearranged. The following pages are certainly not a comprehensive guide to this functionality, but should provide a good working foundation with which to do the most basic form creation, theming, validation, and execution.
This isn't a description. It's an advert. And worse, it's a boast.
It tells you very little. And if like me you are used to creating html forms and processing them with php the subsequent paragraphs leave out most of the important details, such as a list of possible elements, in favour of an example which shows you how to do one thing and precious little else.
Will there ever be an Drupal documentation produced by competent documenters? I've bought two of the books and am little wiser. They are just programmers telling it you from the inside without any understanding of what teaching is about.
