[Gambas-user] Gambas-Documentation

[Fernando Cabral]

Agreed, Honsek. I am a newcomer, I liked Gambas at first sight, but I have
had a hard time finding proper documentation and  good examples on how-to.

- fernando



2017-06-06 7:53 GMT-03:00 Hans Lehmann <hans at ...3219...>:

> A warm Hello to all friends of the Gambas programming language,
>
> many years ago users complained in various Gambas forum posts about the
> lack of books about Gambas in the German language. I liked Gambas from
> the beginning. Its conception allows people, like myself, switching over
> from other environments as well as ambitioned programmers to work on a
> range of different tasks in a single language. This motivated me as early
> as 2008 to design a concept for a Gambas book. For a few years now this
> book is made available online at www.gambas-buch.de. Many chapters have
> already been published. With great effort, the team of authors pursues
> the goal to produce a good description of the components and classes of
> Gambas and to demonstrate their use in example projects. Every chapter
> and its parts are also offered as a PDF file, and archives of the tested
> demonstration projects are available for download.
>
> However, our work on the online book is hampered increasingly because some
> components and their classes have only fragmentary documentation in the
> Gambas wiki, or none at all. By tolerating this condition, the Gambas
> developers throw away opportunities for newcomers to discover and use
> Gambas. A class or component should, in my opinion, only be released after
> its documentation is complete and correct and put on the Gambas wiki.
> Do the developers really believe that a potential Gambas user will read
> all the source code to understand how the properties, methods and events
> work? (I, for one, have never learned C.) To me, for example, it is clear
> after over 44 years as a grammar school teacher -- among others for
> Computer Science -- that nothing motivates more than success und success
> has to be prepared.
>
> This brings us to the crucial point with Gambas: all efforts should
> currently
> be directed towards quickly closing the gaps and flaws in the
> documentation!
> One only learns a language well by speaking it -- and this is only possible
> with a good dictionary! Such an excellent programming language as Gambas
> should enjoy a thorough documentation of the existing components and
> classes
> with small projects or code snippets which show the essential properties
> and methods in action. If you have a look at the current state of the
> documentation, you will see that it is exceedingly incomplete. Do the
> developers seriously think that the Gambas programmers can read in a
> crystal
> ball if all that's known about a class is the names of its properties,
> methods and events?
>
> The software farm with its projects does not replace a systematic treatment
> of the basics of the language. The online book wanted to provide just that
> for the German-speaking Gambas programmers, and those who want to be! If
> none or only insufficient information about the properties, methods and
> events of a Gambas class is available, then a newbie or a Gambas
> programmer,
> who wants to use this class, will resign and turn to other languages.
>
> My wish is essentially just that the developers do their job until the end
> and provide the documentation for their classes, because only then can
> their
> valuable work be truly useful. Only then can Gambas finally make progress.
>
> Honsek
> www.gambas-buch.de
>
> ------------------------------------------------------------
> ------------------
> Check out the vibrant tech community on one of the world's most
> engaging tech sites, Slashdot.org! http://sdm.link/slashdot
> _______________________________________________
> Gambas-user mailing list
> Gambas-user at lists.sourceforge.net
> https://lists.sourceforge.net/lists/listinfo/gambas-user
>



-- 
Fernando Cabral
Blogue: http://fernandocabral.org
Twitter: http://twitter.com/fjcabral
e-mail: fernandojosecabral at ...626...
Facebook: f at ...3654...
Telegram: +55 (37) 99988-8868
Wickr ID: fernandocabral
WhatsApp: +55 (37) 99988-8868
Skype:  fernandojosecabral
Telefone fixo: +55 (37) 3521-2183
Telefone celular: +55 (37) 99988-8868

Enquanto houver no mundo uma só pessoa sem casa ou sem alimentos,
nenhum político ou cientista poderá se gabar de nada.