Language Selection

English French German Italian Portuguese Spanish

Online documentation: what's missing

Filed under

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

Debian-Based Parsix GNU/Linux 8.15 "Nev" Gets First Test Build, Ships GNOME 3.22

Today, October 21, 2016, the developers of the Debian-based Parsix GNU/Linux operating system proudly announced the availability for download of the first test build of the upcoming Parsix GNU/Linux 8.15 "Nev" release. Read more

Open source where possible in Polish Gdańsk

The city of Gdańsk, Poland’s sixth largest city, is using open source software applications where possible. Open source is called an ‘important element’ in the Operational Programmes, made public in August. This document describes the tasks and activities set out by the city to achieve the goals it defined in the Gdańsk 2030 Plus Development Strategy. Read more

Fedora 26 Linux to Retire the Synaptics Driver for a Better Touchpad Experience

Today, October 20, 2016, Red Hat's Fedora Program Manager Jan Kurik informed the Fedora Linux community about an upcoming system-wide change proposal for the Fedora 26 release. Read more

Meet Remix IO, All-in-One Android 7 Nougat-Powered PC, TV Box & Gaming Console

Today, October 20, 2016, Softpedia was informed by Jide Technology, the team behind the popular Android-x86-based Remix OS operating system, about an upcoming device called Remix IO. Read more