Yes, v16 brings a somewhat frustrating "new" approach to documentation. In 
fact, I postponed looking at v16 until there were PDF docs, which were not 
released until several _months_ after v16 came out (there were html docs, 
but no PDF docs). 

I am also frustrated by how the documentation has been handled with the 
R-releases; if you look at the website right now, there are pages (I won't 
call it documentation) for "What's New" for both v16R5beta and v16r4, 
which is great - but there's nothing on v16r3 and v16r2.  Why would I be 
interested in those docs, since those features are included in r4? Because 
the Upgrade manual is so useful to describe the incremental changes in 
that release.  Without it, I have to really dig to find out what I might 
have missed in r2, r3. 

Richard brings up another frustration: Starting with v16 r-releases, there 
really have not been Upgrade manuals, there have been "What's New" pages, 
and I agree - this is NOT documentation.  While one can jump into the 
documentation guided by the "What's New" page, just try to find "What's 
New" page for v16r2 and v16r3...they just aren't there anymore.

I respecfully request that when any version, R-release or not, is 
released, that an Upgrade manual is released in tandem that describes each 
new feature in detail -eg. "real" documentation" - and that these Upgrade 
manuals remain posted in perpetuity just like they have been for pre-v16 
versions.

My $.02 -

Bob Miller
Chomerics, a division of Parker Hannifin Corporation



**********************************************************************
4D Internet Users Group (4D iNUG)
FAQ:  http://lists.4d.com/faqnug.html
Archive:  http://lists.4d.com/archives.html
Options: http://lists.4d.com/mailman/options/4d_tech
Unsub:  mailto:[email protected]
**********************************************************************

Reply via email to