gettingstarted
[Top] [All Lists]

Documentation Errors/The RB "Neverending Story"

To: Getting Started <gettingstarted at lists dot realsoftware dot com>
Subject: Documentation Errors/The RB "Neverending Story"
From: Terry Ford <tmford at shaw dot ca>
Date: Sat, 29 May 2004 07:39:57 -0700
Cc: REALbasic Network Users Group <realbasic-nug at lists dot realsoftware dot com>
Delivered-to: realbasic-nug at lists dot realsoftware dot com
List-help: <mailto:realbasic-nug-request@lists.realsoftware.com?subject=help>
List-id: REALbasic NUG <realbasic-nug.lists.realsoftware.com>
List-post: <mailto:realbasic-nug@lists.realsoftware.com>
Dear REAL Software,

One of the biggest gripes I have had with REALbasic documentation is that the final releases often contain out of date or incorrect information. I have noticed this since my first upgrade to Version 3 from 2.1.

I don't know how many times I have read, "Unfortunately that section of the online reference is out of date and needs to be updated" or "Please report it as a bug against documentation". I've lost track as I don't have enough fingers and toes.

BTW, there should be "Documentation Error" as one of the pop-up selections at the start of a report along with "Feature Request" and "Bug Report".

I understand that Alphas and Betas should be exempt, but more of an effort to update online docs in fc's would allow errors to be reported before the PDF and Printed versions are created. That is, if that's not already too late. In that case, it should be done in the Betas.

To me, Correct Documentation is the 'life blood' of any major Application. This has probably cost RS a lot of new users upgrading after finding that the examples or properties/events/methods in the User's Guide or Language Reference do not work properly. People who subscribe to the lists do get the benefit of these corrections but, as far as I can tell, the vast majority do *not* subscribe to the lists.

I am, personally, so used to this problem that I have learned to live with it.

Also, is there some way that one can subscribe to both the full lists and their Digests; perhaps under a different name or email address? I would like to compare them and decide if I want to go to Digest mode without losing any valuable messages.

Thanks for listening,

Terry Ford

OS X 10.3.4, RB 5.5.2

_______________________________________________
Unsubscribe or switch delivery mode:
<http://support.realsoftware.com/listmanager/>

Search the archives of this list here:
<http://support.realsoftware.com/listarchives/lists.html>

<Prev in Thread] Current Thread [Next in Thread>