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 10.224.137.137 with SMTP id w9mr17352344qat.6.1376146639996; Sat, 10 Aug 2013 07:57:19 -0700 (PDT) X-Received: by 10.49.41.101 with SMTP id e5mr482738qel.7.1376146639979; Sat, 10 Aug 2013 07:57:19 -0700 (PDT) Path: border1.nntp.dca3.giganews.com!border3.nntp.dca.giganews.com!border1.nntp.dca.giganews.com!nntp.giganews.com!fx3no1894454qab.0!news-out.google.com!he10ni1415qab.0!nntp.google.com!fx3no1894444qab.0!postnews.google.com!glegroupsg2000goo.googlegroups.com!not-for-mail Newsgroups: comp.lang.ada Date: Sat, 10 Aug 2013 07:57:19 -0700 (PDT) In-Reply-To: <87pptmb4p9.fsf@VLAN-3434.student.uu.se> Complaints-To: groups-abuse@google.com Injection-Info: glegroupsg2000goo.googlegroups.com; posting-host=69.20.190.126; posting-account=lJ3JNwoAAAAQfH3VV9vttJLkThaxtTfC NNTP-Posting-Host: 69.20.190.126 References: <87ob96ajv6.fsf@VLAN-3434.student.uu.se> <877gfucton.fsf@VLAN-3434.student.uu.se> <87pptmb4p9.fsf@VLAN-3434.student.uu.se> User-Agent: G2/1.0 MIME-Version: 1.0 Message-ID: <88cb99c6-df8b-49f8-ac53-54b737a02c34@googlegroups.com> Subject: Re: 4 beginner's questions on the PL Ada From: Shark8 Injection-Date: Sat, 10 Aug 2013 14:57:19 +0000 Content-Type: text/plain; charset=ISO-8859-1 X-Original-Bytes: 2635 Xref: number.nntp.dca.giganews.com comp.lang.ada:182940 Date: 2013-08-10T07:57:19-07:00 List-Id: On Friday, August 9, 2013 9:33:06 PM UTC-6, Emanuel Berg wrote: > Dennis Lee Bieber writes: > > > While I do sometimes just drop in code snippets, I more often > > prefer the "teach a man to fish" > > Code communicates better than documentation, is my firm belief. There's a *huge* problem with this: superficial understanding. This problem can lead to extremely bad code adopted as "best practice"/"standard practice". An excellent example: PHP's official site. They go to the code side even in the documentation, to the point where the mb/forum attached to the particular function is oft littered with code examples... and usually bad ones once you gain a deeper understanding of what's going on. > I can guarantee you, I study such all code in detail, and my eyes > are trained. I don't kill and yank the code, not learning anything > from it, and then come back, demanding more. Then you're a step ahead of the cut-n-past script monkeys that the "code snipet" style seems to generate -- not to say that code isn't useful but, again, it seems to encourage a lazy psudeo-understanding. > I know, some do that, > on the SX sites not the least. If you do that, then I do agree > reading is a lot better. But if you do that, you're an idiot, and > those tend not to read, either :) LOL - Point.