home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1993 #1 / NN_1993_1.iso / spool / comp / os / linux / 23363 < prev    next >
Encoding:
Text File  |  1993-01-09  |  3.9 KB  |  78 lines
  1. Newsgroups: comp.os.linux
  2. Path: sparky!uunet!hela.iti.org!ais.org!sno
  3. From: sno@ais.org (Stephen Opal)
  4. Subject: Annoying Linux developer habits.
  5. Message-ID: <C0LFHK.F2E@ais.org>
  6. Organization: UMCC
  7. Distribution: wo
  8. Date: Sat, 9 Jan 1993 15:39:19 GMT
  9. Lines: 67
  10.  
  11. Before I start to ragg on my pet peeve, let me say a great big thank you
  12. to the Linux developers and community.  This has been a terrifically
  13. educational experience and a wonderful challenge of experimentation,
  14. failure, and success.  Just the type of thing I was hoping for when I
  15. chose Linux to be my future system of choice.  The availability of Linux
  16. is what caused me to choose buying a 486 motherboard in my upgrade path
  17. from the Amiga (which I still use and love!).  Linus and all the
  18. "distributors", utility hackers, and driver support people have my utmost
  19. gratitude for a project that seems to be coming together nicely.
  20.  
  21. Now my whiney complaint!  It seems that many documentation people love
  22. their TeX and Postscript so much that they forget that most of us are
  23. just 486 people who need explicit directions on how to assemble our
  24. systems.  Exotic text run-off formats inhibit that dramatically.  Lilo
  25. is only distributed with postscript documentation.  Several other packages
  26. have made their "current" documentation only available in TeX.  Us Newbies
  27. don't need that, and just can't handle it!  I don't have TeX or Postscript
  28. installed on my system yet, and I do not have any facility available to
  29. me that does.
  30.  
  31. WE NEED ASCII!!!  One of the biggest complaints in this newsgroup is from
  32. people chastising users who can't seem to read the available info/faq.  I
  33. think we could go a long way in minimizing this "problem" by making the
  34. current documentation available to the lowest common denominator.
  35.  
  36. Whew!
  37.  
  38. On another related note... It appears that documentation is spread all
  39. over the internet directory tree.  A smattering in this directory, another
  40. smattering in that.  A directory tree that seems to have been formed
  41. more than a year ago and never modified for current needs.  So, I am
  42. constantly searching directory trees on tsx-11 and other systems to find
  43. miscellaneous pieces of code.  I am always extremely greatful when someone
  44. posts an "upload notice" that states an explicit path, because once again
  45. I get to go directly to yet another unseen tree.  Without that explicit
  46. path, I might spend hours trying to find one piece of binary or code.
  47.  
  48. We should assemble all the "general need to know" docs at root.  Then each
  49. package would have their own explicit installation/description documents.
  50. Besides, some of these directories need some housework done on them.
  51. 10 to 15 revisions of the same software doesn't help me.  It just scrolls
  52. my screen off at the top, and I lose all those README filenames.  
  53.  
  54. If we really want people to read those very informative words, we need to
  55. make them the first thing they see, and the main thing they want.  It is
  56. against our best interests, forcing users to scour remote archive sites
  57. and making them search through 100's of directories for snippets of 
  58. information.
  59.  
  60.  
  61. Again, let me say that I am extremely appreciative of this entire project.
  62. Support individually and as a group is par-excellant!  Not a day goes by
  63. that I don't read *something* new and useful to me in comp.os.linux.  I'm
  64. *always* finding wonderful new information to use.  Thank you all for
  65. a good job and a strong support level.  Without you, Linux might be just
  66. another opsys.  I truly appreciate the hours hackers and developers need
  67. to take to keep their respective projects updated and easy to install.
  68.  
  69. I understand that this is an all volunteer effort!  I don't wish to ragg
  70. on that at all.  Let's just take a breath and remember that some of the
  71. things you take for granted may be way over the head of some of us
  72. newbies.  More and more Unix illiterates will be visiting now that this
  73. system is available and packaged so nicely.  A little effort now will
  74. go a long way to avoid developer burn-out later.
  75.  
  76. -- 
  77. Stephen N. Opal     sno@umcc.ais.org
  78.