As we zero in on the second “production” release of the Linux kernel, 1.2, the most common complaint I hear about Linux is its lack of documentation. But, is that really a problem? I think not. Here's why.
What this means is that if you are looking for a book on basic Linux commands or how to use the VI editor you have a lot of choices. When you go shopping you just have to say Linux every time you see Unix. Sure, there are some differences, but not many from the user's point of view. As all “Unix-like” systems converge on the various standards, such as POSIX and Spec 1170, the differences disappear. Today there are more differences between a BSD-based version of Unix and a System V-based version of Unix than there are between either of these and Linux.
There is real Linux-specific documentation. The Linux Documentation Project (LDP), headed by Matt Welsh, is producing high-quality documentation. Right now, Matt's own Linux Installation and Getting Started is either included with most CD-ROM distributions or available from the distributor or reseller.
Olaf Kirch's Linux Network Administrator's Guide has been published by SSC and an O'Reilly version is also on the way. The excellent coverage of networking in general will probably make this book the first Linux-specific book to become commonly used by non-Linux (read that as Unix) users as well.
Michael K. Johnson, our editor, is now in the process of updating his Linux Kernel Hacker's Guide (KHG). You will see some of this information in his new monthly Kernel Korner column. And, once it is up to date, SSC plans to publish it.
There are more LDP books on the way. Expect to see a System Administrator's Guide, Programmer's Guide, User's Guide and man pages. And, of course, all of these books are available on the archive CD-ROMs and ftp sites.
Besides the LDP efforts, publishers are getting on the Linux bandwagon. Springer-Verlag has published a book titled Linux: Unleashing the Workstation in Your PC, available in both German and English. O'Reilly is working on a Linux book, and rumors indicate that Benjamin-Cummings and SAMS are working on Linux books. 1995 will probably be the year of Linux documentation.
Many people who are complaining just downloaded Linux off an ftp site or bought an archive CD. In either case, there is lots of documentation available but it doesn't print itself. You need to remember that if you bought SCO Unix you probably dug into your pocket for $1,000 or more as opposed to less than $100 for Linux. Either take some money and buy the books you need or take some time and print out what is on the CD.
The other problem, of course, is getting you to read the documentation. Many CD vendors are now including a small book with the distribution to get you started. People seem less intimidated by a 20-page insert in the CD case than by a 1,000-page manual. Just remember, you may still need that 1,000 pages of documentation to find all the answers.
Yes, there is. Linux is changing so rapidly that it is hard for the documentation to keep up. For example, if you buy a printed copy of the Linux HOWTOs that has been sitting on a bookstore shelf for a few months, most of it is already out of date. Documentation that will be outdated by the time it is printed is not what publishers (or booksellers) like.
But this is one of the reasons the LDP separated the HOWTOs from the LDP books. These books evolved with much feedback from the early users and, as each one becomes stable, they are becoming available in printed form.
Many of the distributors include HOWTOs on their distribution CDs along with browser tools to search, read and print them. The initial focus has been browsers under MS-Windows. (As much as I dislike this dependence on Microsoft, some people are going to need to be able to read the documentation in order to get Linux up and running.)
Matt Welsh, coordinator of the LDP, has recently made the HOWTOs available on sunsite.unc.edu in HTML format (as well as other formats). This means that if you have the HTML format documents in an uncompressed form on your system (some archive CDs have this) you can use a WWW browser such as Lynx or Mosaic to access these documents in hypertext form. And, as the lead time on pressing and distributing a CD is shorter than that for a printed book, the consumer can get the best of both worlds—stable documentation for their bookshelf and up-to-the-minute documentation on the CD.
In conclusion, the Linux community and the publishing community have heard you and are taking action. There is documentation and there will be more. But remember your obligation: support these publishing efforts including the LDP, get the documentation and, last but not least, RTFM.
Phil Hughes is the publisher of Linux Journal.
|Using Salt Stack and Vagrant for Drupal Development||May 20, 2013|
|Making Linux and Android Get Along (It's Not as Hard as It Sounds)||May 16, 2013|
|Drupal Is a Framework: Why Everyone Needs to Understand This||May 15, 2013|
|Home, My Backup Data Center||May 13, 2013|
|Non-Linux FOSS: Seashore||May 10, 2013|
|Trying to Tame the Tablet||May 08, 2013|
- RSS Feeds
- Making Linux and Android Get Along (It's Not as Hard as It Sounds)
- Using Salt Stack and Vagrant for Drupal Development
- New Products
- Validate an E-Mail Address with PHP, the Right Way
- Drupal Is a Framework: Why Everyone Needs to Understand This
- A Topic for Discussion - Open Source Feature-Richness?
- Download the Free Red Hat White Paper "Using an Open Source Framework to Catch the Bad Guy"
- Home, My Backup Data Center
- Tech Tip: Really Simple HTTP Server with Python
- Please correct the URL for Salt Stack's web site
45 min 32 sec ago
- Android is Linux -- why no better inter-operation
3 hours 53 sec ago
- Connecting Android device to desktop Linux via USB
3 hours 29 min ago
- Find new cell phone and tablet pc
4 hours 27 min ago
5 hours 56 min ago
- Automatically updating Guest Additions
7 hours 4 min ago
- I like your topic on android
7 hours 51 min ago
- Reply to comment | Linux Journal
8 hours 12 min ago
- This is the easiest tutorial
14 hours 27 min ago
- Ahh, the Koolaid.
20 hours 5 min ago
Enter to Win an Adafruit Pi Cobbler Breakout Kit for Raspberry Pi
It's Raspberry Pi month at Linux Journal. Each week in May, Adafruit will be giving away a Pi-related prize to a lucky, randomly drawn LJ reader. Winners will be announced weekly.
Fill out the fields below to enter to win this week's prize-- a Pi Cobbler Breakout Kit for Raspberry Pi.
Congratulations to our winners so far:
- 5-8-13, Pi Starter Pack: Jack Davis
- 5-15-13, Pi Model B 512MB RAM: Patrick Dunn
- 5-21-13, Prototyping Pi Plate Kit: Philip Kirby
- Next winner announced on 5-27-13!
Free Webinar: Hadoop
How to Build an Optimal Hadoop Cluster to Store and Maintain Unlimited Amounts of Data Using Microservers
Realizing the promise of Apache® Hadoop® requires the effective deployment of compute, memory, storage and networking to achieve optimal results. With its flexibility and multitude of options, it is easy to over or under provision the server infrastructure, resulting in poor performance and high TCO. Join us for an in depth, technical discussion with industry experts from leading Hadoop and server companies who will provide insights into the key considerations for designing and deploying an optimal Hadoop cluster.
Some of key questions to be discussed are:
- What is the “typical” Hadoop cluster and what should be installed on the different machine types?
- Why should you consider the typical workload patterns when making your hardware decisions?
- Are all microservers created equal for Hadoop deployments?
- How do I plan for expansion if I require more compute, memory, storage or networking?