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

Security: FOSS Updates, More on Marcus Hutchins

Development: DragonEgg, GCC, LLVM, and Java EE

Kernel and Graphics: Android Kernels, Mesa, and Vulkan 1.0.59

  • Android kernels: does upstream matter?
    There is this false narrative floating around in the dev community on how upstreaming breaks drivers and OEM code. Upstreaming breaking drivers and OEM code is not universally true- in contrast, it defies the very definition of a stable kernel. You see, each and every Android device out there runs a version of the Linux Kernel– and it doesn’t have to be the latest version all the time.
  • Mesa 17.2-RC5 Released, Final Should Come Within One Week
    The fifth and final planned release candidate of Mesa 17.2 is now available for testing.
  • Vulkan 1.0.59 Released With Shader Stencil Export
    Vulkan 1.0.59 is now available this weekend as the latest minor update to this high-performance graphics API. As usual, the bulk of this Vulkan 1.0.x point release is made up of document clarification/fixes to the text. Of those changes, nothing too notable stands out for Vulkan 1.0.59 but there is one new extension.

Games: Pillars of Eternity, Ryan "Icculus" Gordon, Paradox Interactive and HTC Vive