Revision as of 08:26, 12 October 2008 by ThorstenStaerk
After 8 years of practical Linux, I have some ideas how Linux documentation in the web could get even better. This is why I started this site. Here is what I think should apply to every tutorial on the web.
- There are no experts. Being an expert enables you to learn even more from a given text. As an expert, you read something and you find things that really "everyone should know".
- Be practical. When I searched for "use camcorders with Linux" in the web, I just wanted to know which application to start to connect my camcorder and transfer the video. One article I found was three pages long, started explaining that with Linux, everything is modular and thus better, then went on to a rant about Microsoft, explained how to compile a Linux 2.2 kernel so firewire works and ended with an explanation that Linux is better than Windows. It just forgot to mention which program to start. Always tell the program to start for a given application.
- Man pages are not enough. Or is there a man page "how_to_install_linux_on_a_usb_disk" and man how_to_use_a_camcorder_with_Linux and man how_to_setup_a_webcam_with_Linux?
- wikipedia is not enough. Wikipedia says about itself it is not a tutorial.