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

today's howtos

Leftovers: Gaming

KDE and Akademy

  • Zanshin 0.2.2 transition release
    Three years, five months and eleven days... yes, it's the elapsed time since our last release announcement. But don't despair! We're still alive and kicking. We've been busy working on our next release which is much more ambitious than the previous one. As part of this future release, we had to adjust a bit how we store some information. That is why today we are announcing a transitional minor release. Behold Zanshin 0.2.2!
  • All the yummies at Akademy 2015
  • Fruits of Akademy
    For the second time I had the chance to attend Akademy, this time in cold and rainy La Coruña. It has been a week of interesting talks, good food (except for one Tortilla incident), and hacking. [...] KRunner History is Back Supposedly this was one of the reason I still saw quite a few people running Plasma 4 during the conference but now there’s no more reason not to do the switch! ;)

LibreOffice 5.0 released

LibreOffice 5.0 builds on the success of the 4.x family, which has been deployed by over 80 million users (source: TDF estimate, based on users pinging for updates), including large organizations in Europe and South America. LibreOffice 5.0 sports a significantly improved user interface, with a better management of the screen space and a cleaner look. In addition, it offers better interoperability with office suites such as Microsoft Office and Apple iWork, thanks to new and improved filters to handle non standard formats. Other improvements have been added to every module of the suite, and Windows 64bit builds (Vista and later) have been added. Read more