MrSwiss wrote:It won't help anybody, to have "the best intro", if it can't be found, by the people, needing it the most ...
Thank you very much for your concern for beginners and for all the help that you give both here and there :-)
As for the beginners then my suggestion would be to give beginners their own start page (with a mix of subsequent pages and references as needed) and then reference to that beginners start page both here https://www.freebasic.net/wiki/wikka.php?wakka=FBWiki and here https://www.freebasic.net/wiki/wikka.php?wakka=DocToc and maybe even under getting started here (?)(might be too much for some but that's were the hello world and primer #1 are) : https://www.freebasic.net/wiki/wikka.ph ... Programmer
(b.t.w. , I am not necessarily saying that I think that the logic in Primer #1 is good enough but I would be hard pressed to attempt to do better myself and not sure that I necessarily could)
What spurred me to the suggestion above is a combination of your post and the fact that I days ago on my local off-line start pages (made using PageBreeze HTML Editor) for my internet browser made a set of links on one of the pages so that it's only a two click operation in browser from start page to get to the linked places (one click to get to the page with all the links and one click to get to the wiki page in question) , I am not suggesting that I am typical or that my links are the best to model after but I have this as saved link list in that order :
https://www.freebasic.net/wiki/wikka.ph ... odeLibrary
https://www.freebasic.net/wiki/wikka.ph ... Programmer
https://www.freebasic.net/wiki/wikka.ph ... yTutorials
https://www.freebasic.net/wiki/wikka.ph ... mpilerHelp
The above list is not even a list of what I necessarily use or have used but more of a list of what I would like to remember to look at later or have on my todo list.
Also I can not list to stuff/pages not there and I can only link to what is there
Anyway , with the general way existing where the wiki is first and foremost the experienced programmers reference (ref. statement by FMX and the overload info at the built-in functions syntax) (which is kind of OK with me to the extend that one are capable to understand it all - which one unfortunately can not with out proper syntax introduction ) then I think that the right attitude to adopt would also be to give beginners their own section where knowledge about stuff (including about the advanced programmers wiki also) is built up from the ground as much as is needed.
So it's like : What does the user need to understand in order to understand , again meaning what is more *basic* knowledge than what. Also it is of no use to dispense knowledge to people without directing their attention/consciousness to the fact that you are doing it : meaning it is of no use that you in lines of programming uses lines like DIM mynumber as Integer interchanged with DIM as Integer mynumber to demonstrate that you can use both and then think that I learn it if you do not tell me and point out to me what you are actually doing because how else could you with any right expect people to notice or maybe even not be confused (?) Along those lines then you can not even expect beginners to pick up on how to put multiple statements on same line if you do not introduce (direct their attention to) the dividing character : making it possible....
I mean if people want to learn basic stuff about computers then they must generally be referred to go else where but with respect to a basic beginners introduction to a language - and I am not specifying where to start here and not trying to set limits for what people are supposed to know - I am leaving that up to others but otherwise then : It will have to start from the ground and then from the ground up is from the ground up.
I am not necessarily suggesting a complete rework , because after proper introduction then a mix of tutorials and references and links to existing pages for e.g. data types , operators , built in functions and so on could maybe do well (?)...
Introducing enough knowledge of......... and establishing an understanding of the logic used and needed to understand more / the rest
Of course there are still need for more and better documentation about important features and stuff but again I know mostly only what problems I have had and what refers to that - not that I have burdened this forum every time I have had problem understanding something and not that I can even remember all the stuff I spent much time trying to find out
But final advice to anybody interested in making stuff more beginner friendly is this (which some may find a little peculiar) :
Do not rush into making all this , instead start spending the time with principles and with making outlays and designing. I think that designing the way and the order (sequence) by which information is dealt and introduced is as important as the how the information itself is introduced/dispensed.....
Sorry , I get a little carried away some times , but I mean well , and just my two cents I guess :-)