In answer to a quetion concerning manuals for A5 V5, Selwyn
sent the following.
=======================================================================
Msg ID: 19462
Subject: RE: Selwyn - suggestions on V5 manuals
Author: Selwyn Rabins
Date: 04-18-2000 20:40
File:
thanks
we will probably end up with seperate books for
user guide
functions
xbasic
getting started
and learning xbasic.
======================================================
There is a recognition that the present Xbasic manual needs an overhaul.
Three of the manuals (Xbasic, Learning Xbasic, and Functions) will
replace the present Xbasic manual. Hopefully, these wil help those who
are reluctant to use Xbasic might be encouraged to do so. They will profit
from that. This great board will help newbies get over the humps.
1. The Xbasic commands have an inherent structure (I hope). It would help
to know the naming cpnventions - ie the use of periods and _'s. This
might help avoid using them incorrectly.
2. There should be 4 or 5 detailed, well documented Xbasic programs
that illustrate the use of the most commonly used commands as well
as the use of :, @, and other "odd" symbols. Of course, the
judgment of what is common is subjective, but whatever is
selected it would be better than searching snippets of code as
given in the present manual. These programs should be geared to
specific databases that can be downloaded from your web site.
3. It is probably difficult for an expert in Alpha to write manuals
that are user friendly. What he/she may think is obvious may not
be so, especially for new users. It is a real challange. Perhaps
Alpha can post preliminary copies on the web site for review. Of
course, details on new features would have to be suppressed to foil
competitors. There many divergent views but hopefully there would be
a consensus on some.
4. The notion of a separate manual on functions is great. The present
treatment in the Xbasic manual is weak. We need more diverse
examples on how to construct UDF's. This should encourage more
users to use this powerful tool.
With regard to the sample databases that are shipped with Alpha,
it would be nice to have a description of what each is attempting
to illustrate. Perhaps these descriptions might be on your web site
rather than in a manual. BTW will they be changed in any to reflect
some of the new features?
Any thoughts, Selwyn and users, on these matters?
sent the following.
=======================================================================
Msg ID: 19462
Subject: RE: Selwyn - suggestions on V5 manuals
Author: Selwyn Rabins
Date: 04-18-2000 20:40
File:
thanks
we will probably end up with seperate books for
user guide
functions
xbasic
getting started
and learning xbasic.
======================================================
There is a recognition that the present Xbasic manual needs an overhaul.
Three of the manuals (Xbasic, Learning Xbasic, and Functions) will
replace the present Xbasic manual. Hopefully, these wil help those who
are reluctant to use Xbasic might be encouraged to do so. They will profit
from that. This great board will help newbies get over the humps.
1. The Xbasic commands have an inherent structure (I hope). It would help
to know the naming cpnventions - ie the use of periods and _'s. This
might help avoid using them incorrectly.
2. There should be 4 or 5 detailed, well documented Xbasic programs
that illustrate the use of the most commonly used commands as well
as the use of :, @, and other "odd" symbols. Of course, the
judgment of what is common is subjective, but whatever is
selected it would be better than searching snippets of code as
given in the present manual. These programs should be geared to
specific databases that can be downloaded from your web site.
3. It is probably difficult for an expert in Alpha to write manuals
that are user friendly. What he/she may think is obvious may not
be so, especially for new users. It is a real challange. Perhaps
Alpha can post preliminary copies on the web site for review. Of
course, details on new features would have to be suppressed to foil
competitors. There many divergent views but hopefully there would be
a consensus on some.
4. The notion of a separate manual on functions is great. The present
treatment in the Xbasic manual is weak. We need more diverse
examples on how to construct UDF's. This should encourage more
users to use this powerful tool.
With regard to the sample databases that are shipped with Alpha,
it would be nice to have a description of what each is attempting
to illustrate. Perhaps these descriptions might be on your web site
rather than in a manual. BTW will they be changed in any to reflect
some of the new features?
Any thoughts, Selwyn and users, on these matters?
Comment