|
Post by rosy on Nov 6, 2021 9:18:53 GMT -6
johnno56, maybe you would be busy editing the manual? Right now it's terrible and I don't have time and I don't know English.
|
|
|
Post by johnno56 on Nov 6, 2021 15:03:39 GMT -6
Documentation has always been one of the aspects of a programming language that has the ability to convince people to either accept or reject that language. I still have my old Amstrad User Manual, for when I use the emulator, because I could never remember all of the commands and functions. That was 1985 and I still not mastered it... lol
Microsoft's basic and QB64 have the kind of help system that is, in my opinion, pretty good. Every command description is highly detailed and one or several examples are included with cross references to other similar commands. I am not saying that we should have a similar system, although that would be nice, but just a manual that explains every command and provides an example would be great.
One thing that Microsoft has that we do not... Is a dedicated 'team' to setup the help system then a minimum crew to keep it maintained. We have a team of one. I am not making an excuse, just stating the fact. Our Administrator has limited time to dedicate to all aspects of RC. Our "manual" is a simple HTML file (well, maybe not so simple.. lol) and is accessible to all. Some time ago, several of us, were working on the manual but for some reason the effort kind of faded away.
To make a long story short... I will have another look at the manual and will try to to what I can. There are many aspects of RC that I do not fully understand and my programming skills are 'not the best', but I will try.
|
|
|
Post by rosy on Nov 6, 2021 15:52:16 GMT -6
Write what you know, and if you don't know something - ask. This is how it should look like you described. First of all, the command index should contain all commands, not ...
|
|
|
Post by johnno56 on Nov 6, 2021 21:05:00 GMT -6
hmmm... your last posting seems incomplete.
|
|
|
Post by johnno56 on Nov 6, 2021 21:54:32 GMT -6
RCBasic install can install a configuration file for the Geany IDE/Text editor. Within the config file is a list of all RC's reserved words: About 412 words. Can you imagine the size of a physical manual if each entry just had the Word, Word format, Word Description then an example of code? The online manual has most of that information. There are 'many' reserved words that do not have sample code snippets. If I can get a copy of the manual then I can start to work on it.
|
|
|
Post by rosy on Nov 7, 2021 0:35:51 GMT -6
I can imagine, because you yourself gave examples of such.
|
|