Creative Documentation

FuriousCurio writes "Linux kernel hackers appear to be an endlessly creative group of individuals. In response to previous documentation attempts not having been read by many people, KernelTrap is reporting about how the lguest documentation was prepared to be something of an adventure story. Self-proclaimed to turn you into an lguest expert, lguest being one of the new solutions for running a virtual instance of the Linux operating system as a user process within a real instance of the Linux operating system, the documentation mixes humor and wit into puzzles, poetry, and of course source code and a low-level understanding of virtualization. But the questions remains, will making documentation more entertaining actually work to get people to read it?"

Comments

Pffft, Old Hat

[Fx.Dr]

If you compile the Anarchists' Cookbook you wind up with Windows 3.11 for Networking.

I thought my Linux education was going well...

[Rob T Firefly]

...until I was eaten by a Grue.

Q1. What is lguest?

[GillBates0]

Q1. What is lguest?
A. RTFM n00b.

wrong forum

[Joe Snipe]

here at slashdot we can't even rtfa, let alone rtfm.

Re:Short answer: no

[plover]

Tech docs ... shouldn't be, read start-to-finish, any more than a dictionary should.

Aha! So that's why I know so freakin' much about aardvarks, but jack sh!t about zebras.

Re:Yes....

[gardyloo]

Agreed, and I try to work around it with the following question line to clients: "Say you have two drivers. One is familiar with the state Driver's Handbook and traffic laws, having read up on them. The other has just got behind the wheel for the first time. Which one do you think would get in more accidents, and why?" Whichever one ATI wrote.

You are in a dusty kernel driver directory

[billstewart]

A stairway called .. leads up.
A directory called "docs" leads down to the left.
There are files here.