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,FREEMAIL_FROM autolearn=unavailable autolearn_force=no version=3.4.4 X-Received: by 2002:a24:294f:: with SMTP id p76mr7888325itp.34.1543866206271; Mon, 03 Dec 2018 11:43:26 -0800 (PST) X-Received: by 2002:aca:5395:: with SMTP id h143mr289217oib.6.1543866205889; Mon, 03 Dec 2018 11:43:25 -0800 (PST) Path: eternal-september.org!reader01.eternal-september.org!feeder.eternal-september.org!news.mixmin.net!proxad.net!feeder1-2.proxad.net!209.85.166.215.MISMATCH!k10no640495itk.0!news-out.google.com!v141ni765ita.0!nntp.google.com!k10no640493itk.0!postnews.google.com!glegroupsg2000goo.googlegroups.com!not-for-mail Newsgroups: comp.lang.ada Date: Mon, 3 Dec 2018 11:43:25 -0800 (PST) In-Reply-To: Complaints-To: groups-abuse@google.com Injection-Info: glegroupsg2000goo.googlegroups.com; posting-host=176.130.29.212; posting-account=6yLzewoAAABoisbSsCJH1SPMc9UrfXBH NNTP-Posting-Host: 176.130.29.212 References: <9524b3ee-476f-4af6-ab83-b15a6c2a417c@googlegroups.com> <6508fa19-5b93-471a-8b06-216907736b1b@googlegroups.com> <960eb922-6ea5-47d6-af48-289fff1f6fb5@googlegroups.com> User-Agent: G2/1.0 MIME-Version: 1.0 Message-ID: <31d76c8f-5e0b-4f64-88fd-34dcd63c19d6@googlegroups.com> Subject: Re: GNATCOLL JSON Parsing From: briot.emmanuel@gmail.com Injection-Date: Mon, 03 Dec 2018 19:43:26 +0000 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Xref: reader01.eternal-september.org comp.lang.ada:54932 Date: 2018-12-03T11:43:25-08:00 List-Id: > 2) Man, I would practice due diligence before biting. My https://github.c= om/ohenley has 12 repos. I was talking about repositories with some doc. "amoc" -> no comment, except for copyright header "aglw-demos" -> no comment either. The other Ada repositories are all forked from existing projects. I did check before I commented... > ii. A simple native Mouse Capture in Ada. Toy project grabbing the coords= of a PC mouse and outputting it to the terminal. Code in is very straightf= orward, clean and naive... on purpose. Not using any 'mad' dependencies. In that single sentence, there are more comment than in all the repository. You actually fell to the same criticism you made earlier: "code is straight= forward". For you as the author, I have no doubt. For someone looking at yo= u repository =3D> no idea what it does, except it has something to do with = "mouse". There is no high-level description, no code example,... I understand this is work-in-progress, and I am glad to see more Ada reposi= tories. My point (and I believe Dmitry's, both of us having shared a number= of repositories) is exactly that it is so easy for authors to assume somet= hing is "straightforward" (to quote you). There is always someone for whom this isn't the case. That person needs to = report on that (and this thread was initially a good example of that: a pro= blem with GNATCOLL.JSON, which might eventually get reported to the authors= ), or ask questions (more Ada questions on stackoverflow cannot hurt, thoug= h it will be more work for Simon). The author of the library of course get to decide where to draw the line be= tween "obvious, doesn't need doc", and "yes, let me add some doc". > No but you could definitely point out a clear resource that does it (a ur= l staring by http://...), what about that? For the particular example I sent that resource is called the Ada Reference= Manual, though any book on Ada also have that info. I must admit that I am= not current on getting-started resources for Ada. > But if you want to bring back Ada strong we will have to push harder. GoF= Patterns in Ada, games, more blogs, super robust JSON, bindings to Graph d= atabse (eg DGraph, Noe4j) etc Every little progress will be nice. Don't think though that Ada will become= mainstream again, that time has passed, and a lot of people just prefer to= look at the new and shiny. > Seriously!? I really though I could approach people this way...=20 I know this is ironic, but you would not believe the number of request for = help that have exactly that tone. > I said SOME of the old guard, so if you feel concerned it is on you, sorr= y. I don't mind being the old, middle-aged or new guard, doesn't matter to me. > But, all that said, I know I was a bit too harsh. I would really like to = have Ada praised everywhere. That is why I am shaking the tree. That won't work. What works is publishing things (Code, tutorials, doc,...)= Why don't you start collecting the information from comp.lang.ada threads = and make that available in a nice form, for instance ? Or publish resources for Ada beginners (the "old guard" cannot help here, w= e just assume some of the things are obvious). Your list of awesome-ada seems like it could be a good starting point. But = if you don't advertise it, this is wasted effort. And as soon as you advert= ise it, you will get comments from people "your list is stupid because it d= oesn't include such and such"... Then you will become part of the middle-ag= ed guard. Emmanuel