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

Leftovers: Software

today's howtos

Leftovers: Gaming

Can Marten Mickos make 'Linux for the cloud' work for HP?

Hewlett-Packard didn’t just buy cloudy startup Eucalyptus Systems to build its fledgling OpenStack cloud biz, it also bought Marten Mickos, the firm’s Finnish CEO. HP isn’t the first to pay for Mickos' expertise - that was Sun Microsystems, when it acquired his venture previous venture, MySQL AB, for $1bn in 2008. Read more