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?"

One of the problems will be in what some people consider "funny". Would you have read the documentation if it went like this?

Narrator: In A.D. 2007, virtualization was beginning. LGuest: What happen ? Machine: Somebody set up us the guest kernel. User: We get host OS. LGuest: What ! Operator: Main OS boot up. LGuest: It's you !! Hypervisor: How are you gentlemen !! Hypervisor: All your kernel are belong to us. Hypervisor: You are on the way to virtualization. LGuest: What you say !! Hypervisor: You have no chance to survive make your time. Hypervisor: Ha Ha Ha Ha.... User: Captain !! LGuest: Take off every 'IO' !! LGuest: You know what you doing. LGuest: Move 'IO'. LGuest: For great justice.

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?"