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

Optimize your Linux rig for top-notch writing

I'm a big fan of Scott Nesbitt's writing, which has a technological bent, but is usually more about working effectively, rather than how tools can make you effective, which is a key distinction. Scott's setup reflects his focus on production rather than tweaking. He has his work tools and everything else is pretty much white noise—which is why LXDE/Lubuntu probably makes a lot of sense for his workflow. It's simple and it stays out of his way. Scott also gets bonus points for moving his family to Linux. That's a tough move, but given that his wife stole his ZaReason laptop, the conversion seems to have taken. Read more

IBM meets demand for Linux with training resources

IBM HAS REAFFIRMED its commitment to Linux with the announcement of an extension to Power Systems Linux. Following on from the company's $1bn financial commitment to the Linux operating system last year, IBM will add Power Systems Linux to the Power Systems services already available for AIX and IBM iSeries servers at 54 IBM Innovation Centres and Client Centres. This will enable Linux systems to better use IBM's Power8 parallel processing and advanced virtualisation. Read more

How Red Hat can catch the developer train

Outside the operating system, according to AngelList data compiled by Leo Polovets, these developers go with MySQL, MongoDB, or PostgreSQL for their database; Chef or Puppet for configuration; and ElasticSearch or Solr for search. None of this technology is developed by Red Hat. Yet all of this technology is what the next generation of developers is using to build modern applications. Given that developers are the new kingmakers, Red Hat needs to get out in front of the developer freight train if it wants to remain relevant for the next 20 years, much less the next two. Read more

Shortlist of open source software used at NASA lab

The offer was too good to be true. Three whole weeks at the NASA Glenn Research Center and an invitation to come back. I could scarcely believe it when I read the email. I immediately forwarded it to my parents with an addition of around 200 exclamation points. They were all for it, so I responded to my contact, Herb Schilling, with a resounding “YES!” Read more