Floss Documentation and Manuals

It is a fact that free, libre and open source software (floss) use is on the rise. Still, the momentum is not as steep as developers want it to be. One major handicap for propagation of floss applications is the lack of clear and concise documentation. Some may argue that there is enough documentation to get anyone going. Not quite so!

A few months back I wrote a how-to about uploading a favicon to a Blogspot blog. Yesterday, I asked a friend who had a blog, if he could upload a favicon according to my instructions in the article. He tried and came back telling me he was unable to understand it. What went wrong?

Apparently I failed to put my feet into the shoes of a completely novice user. What was clear for me, was not so clear for him.

It is really a sort of black voodoo to accomplish such a task. Human mind plays tricks and thoughts outpace words.

I came across Floss Manuals a few days ago, and that is why I arranged the aforementioned test.

FLOSS Manuals make free software more accessible by providing clear documentation that accurately explains their purpose and use. Each manual explains what the software does and what it doesn’t do, what the interface looks like, how to install it, how to set the most basic configuration necessary, and how to use its main functions. To ensure the information remains useful and up to date the manuals are regularly developed to add more advanced uses, and to document changes and new versions of the software.

You can find quality documentation for various floss applications like Inkscape, OpenOffice, Firefox, Muse, NvU, Audacity, Blender, etc. Definitely worth a look.

Comments

Post a Comment

Popular posts from this blog

Pros of Short Domain Names

Life is a good teacher. Up to now, it has never occurred to me a short domain name could be an advantage. I have always assumed, because I do it that way, people could bookmark a site when they like it regardless of the length of its name. Though I do not use it, social networking sites like Twitter changed my mind. I suddenly realized how difficult it must be to write a tweet about an article on this site without the aid of URL shortener services. Just writing the part "experimentsincyberspace/2009/04/" with the protocol prefix consumes 52 characters. I am not saying you will not be found. I am talking about the extra step, often tedious, of the necessity of shortening the URL. A very good idea could be having a short URL handy beneath or above your articles so that people can easily use it. Rather than having your visitors do it, you can take the extra step and place a short link yourself. In addition, keeping your URL intact can be a marketing and branding advantage.
Read more

A Thought Experiment on Do Follow Comments

Image
Einstein was a great scientist and without exception all physics students new to his work are introduced to his use of Gedanken Experiment or thought experiments. Gren Ireson, a lecturer at Loughborough University, UK, where his research interests include quantum philosophy, physics of sport and learning and teaching physical sciences, contests that a thought experiment has three requirements [PDF]: It is carried out in the mind (however one cares to define 'mind'). It draws on experience. It allows the experimenter to see what is happening (perhaps a better term to use than 'see' is 'imagine' or 'form a mental image').  I see a lot of blogs announcing they do follow comments lately, so I will humbly use Einstein's technique to shed some light on do follow commenting today. Let us start with a definition first. Google's Matt Cutts speaks: The nofollow attribute is just a mechanism that gives web masters the ability to modify PageRank flow
Read more

New Rush for Top Level Domains Begins

It will shortly, if ICANN's new proposal holds up, that is. According to Paul Levins, VP corporate affairs, any domain name will be possible, subject to your imagination, The familiar .com, .net, .org and 18 other suffixes — officially "generic top-level domains" — could be joined by a seemingly endless stream of new ones next year under a landmark change approved last summer by the Internet Corp. for Assigned Names and Numbers, the entity that oversees the Web's address system. Tourists might find information about the Liberty Bell, for example, at a site ending in .philly. A rapper might apply for a web address ending in .hiphop. [...] To beat a competitor to the punch, a company might decide it needs to control a new generic domain, such as .cereal or .detergent, but it would be costly. The currently proposed application fee is $185,000, plus an annual "continuance" fee of $25,000. If more than one company wants a suffix, there could be a bidding w
Read more