I couldn’t agree more. Each version needs it’s own document that lists it’s changes. I also agree about keeping an archive of documentation for each R release. There’s new stuff in each one, that’s the whole point, and an R release is no different than a major version release - once you get to v16R5 that’a the last - the next one is v17.
------------------------------------------------ Richard Wright DataDomain rwri...@datadomainsoftware.com ------------------------------------------------ > On Fri, Oct 6, 2017, at 2:00 PM, 4d_tech-requ...@lists.4d.com wrote: > > Message: 6 > Date: Fri, 6 Oct 2017 12:39:40 -0400 > From: bob.mil...@parker.com > To: 4d_tech@lists.4d.com > Subject: RE: What happened to 4D documentation in R releases? > Message-ID: > <of1d804ade.6da3fe9d-on852581b1.005a7e7a-852581b1.005b9...@parker.com> > Content-Type: text/plain; charset="US-ASCII" > > 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:4d_tech-unsubscr...@lists.4d.com **********************************************************************
