One thing that would have helped me when I was first learning to program is just a tutorial on how to read documentation.   There are so many tutorials out there that explain the documentation in english but nothing that actually teaches you how to read the documentation.  The documentation is a language unto itself:

14.2.9 SELECT Syntax

14.2.9.1 SELECT ... INTO Syntax
14.2.9.2 JOIN Syntax
14.2.9.3 UNION Syntax

SELECT
    [ALL | DISTINCT | DISTINCTROW ]
      [HIGH_PRIORITY]
      [STRAIGHT_JOIN]
      [SQL_SMALL_RESULT] [SQL_BIG_RESULT] [SQL_BUFFER_RESULT]
      [SQL_CACHE | SQL_NO_CACHE] [SQL_CALC_FOUND_ROWS]
    select_expr [, select_expr ...]
    [FROM table_references
      [PARTITION partition_list]
    [WHERE where_condition]
    [GROUP BY {col_name | expr | position}
      [ASC | DESC], ... [WITH ROLLUP]]
    [HAVING where_condition]
    [ORDER BY {col_name | expr | position}
      [ASC | DESC], ...]
    [LIMIT {[offset,] row_count | row_count OFFSET offset}]
    [PROCEDURE procedure_name(argument_list)]
    [INTO OUTFILE 'file_name'
        [CHARACTER SET charset_name]
        export_options
      | INTO DUMPFILE 'file_name'
      | INTO var_name [, var_name]]
    [FOR UPDATE | LOCK IN SHARE MODE]]
I mean what language is that?  It looks like mysql.  Is it intended to be clear?  I can kind of get an idea and it's not as bad as some things I've come across.  I don't think this would actually run if I ran it.  Maybe it would.  I just wish I'd come across tutorials on reading documentation.  Back in 1990 I got a free public domain C compiler that was advertized in a magazine.  (This was just before the internet).   I never got it to work however there were several disks loaded with documentation.  I just could barely understand the documentation.   Compiling a C program involves more than just understanding the C language.  On top of all the obscure documentation there is Assembly Language involved.   On top of that the Makefile is written in another language.  The makefile allows you to type the word make at the command line and the file will make itself.  All the books at that time only focused on the C language so you really couldn't take advantage of free software.   The expensive software would always include a way for you to go straight to programming.      However you would have to pay large amounts of money to get the hand holding you needed.     It was totally worth it of course if you could somehow get your hands on those tools and the hardware that would run it.   Just having the money wasn't enough you had to live in either New York or Los Angeles or Chicago because other cities didn't sell that stuff.

My main point though is that Documentation is a language unto itself and it's a language with no name and no Documentation of it's own.   Colleges need to teach a course in deciphering documentation and maybe YouTube could use some tutorials on it. 

Comments

Post a Comment

Popular posts from this blog

Parable of the Growing Seed, And the Mustard Seed

The Parable of the Growing Seed 26  He also said, “This is what the kingdom of God is like. A man scatters seed on the ground. 27  Night and day, whether he sleeps or gets up, the seed sprouts and grows, though he does not know how. 28  All by itself the soil produces grain—first the stalk, then the head, then the full kernel in the head. 29  As soon as the grain is ripe, he puts the sickle to it, because the harvest has come.” This is saying that just by reading the Bible the word of God you will grow spiritually.   It has an effect on you that you don't understand.   It works on you in ways you don't know without you realizing it.  Your heart will love more.   You will be better able to resist temptation.   It's not just about understanding the Bible and learning things or what to do and not to.   It's not just a set of rules (although it is that also)   It's a way of becoming what you want to be.   It takes time though.    Sometimes it takes a generation o
Read more

Weird Trick for Making Great Art.

Draw finished drawings right from the start. This is only a trick and not really what you would think of as something a pro would do however. It works because random thoughtless art is better than most artists techniques and hard work. You can think things through and through but for most artists they aren't going to improve on random chance. There probably is a technique that improves on random chance but I'm not sure I've figured it out and I'm not sure anyone has. Anyway Travis Charest would draw finished art right from the start and it looked amazing. It saved time too. Stick figures are good if you are just learning and they are always good but so is finished drawings right from the start because the less you erase and the more precise your lines the easier it is to draw the next line in the perfect spot. Random placement of figures will look really good most of the time because in the end even when you are doing roughs you are attempting to create
Read more

Fish Tank Optics.

Image
Why does the far side of a fish tank appear closer than it is when it's full of water? The reason is that the light-waves while in the tank radiate in a circular manner when they leave the tank they are now radiating in a non-circular manner.  The planes of those waves will hit your eyes at a vastly different ways.  One eye will see the fish straight on while the other eye will see it sideways.  As a result it's possible that in a way the fish will actually appear to be outside the tank.    Perhaps that would explain the somewhat queezy feeling you can get while looking into a fish-tank.  One eye will see the plane of one light wave while the other eye will see the plane of another.  It's not that the light bends is it?   It's more like the wave front is at an odd angle.   Where the light at first radiated spherically it is now radiating as an ellipsoid or Jelly bean shape.  Here I'm showing a cross section so that it appears as ellipses.   I think using
Read more