I'll second that!
Since we're on the documentation here are some gripes of my own:
Why don't the hard copy docs have the TAG NAMES or FUNCTION NAMES printed at the
header or footers or at the top of each page? It's terribly inconvenient to find
anything. If you flip through the book 75% of the time you have no idea where you are
without reading the text. Just the simple addition of names at the top of each page
would make finding things so much faster.
Why are there so many useless descriptions of tags and functions with such
illuminating explanations as: Value=value.
The reference manual is NOT a reference manual. A reference manual is supposed to be a
comprehensive definition of the language. This leaves SO MUCH unsaid that I have to
search between all three Allaire books, two Ben Forta books, the Danesh book, and the
online Knowledge Base to find answers to simple questions. To pick one at random:
REFind. No list of what RegEx expressions are valid. So I turn to my Perl docs. There
it is in complete detail... but sorry they are not compatible... So where *DO* I
finally find the list? In a knowledge base article about HomeSite.
One of the reasons I am so productive programming in the Unix environment is that
everything is so well documented.
I wish that were nearly true of Cold Fusion.
At 11:52 AM 9/29/00 -0400, Steve Bernard wrote:
>To some this may seem trivial but, the PDF documentation HAS to get fixed.
>For many this is the only documentation that they have for 4.5.x and quite
>frankly, it sucks. It's not the content, it's the usability. In earlier
>versions, especially the 4.0.x series, the included and downloadable PDF
>documentation was thorough and well built. There were bookmarks, thumbnails,
>and the links all worked. Starting with CFAS 4.5 the PDF's have none of
>these, which makes them almost useless. "Hmmm, was CFREGISTRY on page 171 or
>117? What page number is the end of tags and the beginning of functions? Why
>don't these darn bookmarks work!?" You get the picture. Not everyone uses
>Studio and many CF servers have the HTML documentation removed. If PDF was
>only supposed to be a supplement my opinion would be different but, for
>upgraders, purchasers of electronic distributions, or those who do not use
>Studio the PDF docs are all that they have. Unfortunately, Allaire's
>documentation has always had problems, whether it be incompleteness,
>inaccuracy, lateness, or terrible physical quality. The documentation group,
>Margaret et al., made great strides in the 4.0.x series but, things seem to
>be crumbling again.
>
>Regards,
>
>*****
>
>Steve Bernard
>
>
>------------------------------------------------------------------------------
>Archives: http://www.mail-archive.com/[email protected]/
>To Unsubscribe visit
>http://www.houseoffusion.com/index.cfm?sidebar=lists&body=lists/cf_talk or send a
>message to [EMAIL PROTECTED] with 'unsubscribe' in the body.
---------------------------------------------------------------------------
Peter Theobald, Chief Technology Officer
LiquidStreaming http://www.liquidstreaming.com
[EMAIL PROTECTED]
Phone 1.212.545.1232 x204 Fax 1.212.679.8032
------------------------------------------------------------------------------
Archives: http://www.mail-archive.com/[email protected]/
To Unsubscribe visit
http://www.houseoffusion.com/index.cfm?sidebar=lists&body=lists/cf_talk or send a
message to [EMAIL PROTECTED] with 'unsubscribe' in the body.
