Language Selection

English French German Italian Portuguese Spanish

Online documentation: what's missing

Filed under
Misc

For several years I’ve been fascinated with technical information people get online, instead of from books or journals. Everybody looks online for help installing software, finding programming library calls, fixing bugs, and solving any other technical problem they have on their systems. (Systems, not computers–computers are boring, Steve Jobs told us that. Nobody wants to be associated with computers any more.)

A lot of information is still missing online. That’s good for O’Reilly, because it means the book industry still plays an important role. But this article is not about missing information in general. It’s about a specific segment of missing information: the frustration you feel when you visit a site and don’t understand it because it lacks some background you need.

Missing information is not such a widespread problem in books, because authors have space to lay out background. In fact, I believe the defining characteristic of a well-written technical book is its success in providing the necessary background.

Full Story.

More in Tux Machines

arkOS Sunset

When I started arkOS back in late 2012, I was moved by the idea of creating a new and innovative software stack and operating system that could bring self-hosted server applications to a wide audience. The vision has always been the same: to give the masses the tools and education they need to properly self-host all of their software needs in one place. This project has spawned many different ideas and micro-projects from many different developers including myself, and has helped contribute (I hope!) to a renewed interest in the decentralized "do-it-yourself" internet we have seen with the rise of projects like Indieweb, Sandstorm, Mastodon and more. Read more

[Stable] OpenELEC 8.0.2 released

OpenELEC 8.0.2 release has been published. Users running OpenELEC 8.0.0 or later with auto-update enabled will be prompted on-screen to reboot and apply the update once it has been downloaded and enabled in some hours. Users running older OpenELEC releases or with auto-update disabled will need to manually update. If you would like to update from an older OpenELEC release please read update instructions/advice on the Wiki before updating. Manual update files can be obtained from the downloads page. Read more

Red Hat Financial News

Android Leftovers