From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on polar.synack.me X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00 autolearn=unavailable autolearn_force=no version=3.4.4 Path: eternal-september.org!reader01.eternal-september.org!feeder.eternal-september.org!aioe.org!.POSTED!not-for-mail From: "Dmitry A. Kazakov" Newsgroups: comp.lang.ada Subject: Re: GNATCOLL JSON Parsing Date: Mon, 3 Dec 2018 19:06:10 +0100 Organization: Aioe.org NNTP Server Message-ID: References: <9524b3ee-476f-4af6-ab83-b15a6c2a417c@googlegroups.com> <6508fa19-5b93-471a-8b06-216907736b1b@googlegroups.com> NNTP-Posting-Host: 6RgwMQWCXnjFVePlk7FG5g.user.gioia.aioe.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit X-Complaints-To: abuse@aioe.org User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:60.0) Gecko/20100101 Thunderbird/60.3.2 X-Notice: Filtered by postfilter v. 0.8.3 Content-Language: en-US Xref: reader01.eternal-september.org comp.lang.ada:54926 Date: 2018-12-03T19:06:10+01:00 List-Id: On 2018-12-03 16:02, Olivier Henley wrote: >>> The problem is that the authors do not provide practical examples of using >>> libraries. It is difficult for a beginner to understand what to do. > > I totally agree. It is like some authors > > a) do not want others to use their stuff > b) think that Ada does not need new kids around > c) think you need to pass some kind of implicit test to be 'blessed' in using their stuff > d) want some form of 'extended special attention' from strangers > > ... It is always related to some form of God complex ... Authors simply cannot provide any good getting started samples: 1. Their perspective is massively distorted by the level of knowledge of the software internals. Things that appear them obvious can turn a total mystery for a beginner. 2. Authors know surprisingly little about the potential application of their software. They have some general guesses about the purpose, but nothing substantial about concrete uses. They usually get quite astonished (horrified? (:-)) the ways end users apply their software. 3. Writing introductory material requires a great deal of teaching talent to write. Most authors lack it. It is a different job and different qualification. At best an average author can write a decent reference manual, nothing more. Ergo, it must be a third person to write samples and introductory stuff. > I cant stand that kind of 'counter-productive' attitude. It is not a competence issue, its just people want to get going, period. Personally I don't have the time to get in the head of some authors, don't have the time to dive in their code (from the lib perspective I'm a client not a contributor) and frankly not actually interested to understand until I know at least what they publish actually works. So many projects are broken right from the start. > > Ada, being nowhere on the popularity charts should really streamline its 'tutorials' offering for surviving. Some of the old guard seems to be completely disconnected from that fact. No wonder something like Rust is taking over the world... when we already have Ada. They have a much bigger community with much more people available to write independent manuals, samples, blogs, make youtube videos. They have lost of people eager to describe their experience with deploying particular software for particular projects, we do not. -- Regards, Dmitry A. Kazakov http://www.dmitry-kazakov.de