ONJava.com -- The Independent Source for Enterprise Java
oreilly.comSafari Books Online.Conferences.

advertisement

AddThis Social Bookmark Button
Article:
  Is Linux Annoying?
Subject:   Documentation
Date:   2003-09-16 09:19:07
From:   anonymous2
Now I'm a real beginner with Linux, so maybe this annoyance will lessen with time and knowledge. I'm well aware of the wealth of information available about Linux (or GNU/Linux, for the purists...) The problem/annoyance is the level at which so much of this information is pitched. i can't give chapter and verse, but a humorous example goes something like this:


HOWTO for app XYZ-2.4.11


1. Clear comprehensible first step.
2. Clear comprehensible second step..
3. Gee I'm getting somewhere...
4. "Steps 4, 5 and six are trivial and not worth documenting since everyone knows and understands them...


Except me? So...


$ man XYZ
$ extremely logical and carefully crafted gibberish incomprehensible to newbies....


$ lynx http:// homepageforapp.org


more very logical advice incomprehensible to newbie...


Maybe I get lucky on a forum....but all this can be annoying....and maybe when I know more I can help by writing a simpler doc for the app in question. In the meantime.....AAARGH!



1 to 2 of 2
  1. Documentation
    2003-09-26 23:29:01  anonymous2 [View]

    • Documentation
      2003-10-11 15:51:25  anonymous2 [View]

      • Documentation
        2003-11-29 17:22:12  anonymous2 [View]

  2. Very true
    2003-09-16 13:09:34  anonymous2 [View]

1 to 2 of 2