FOSS Documentation.

I have just read this article on documentation or rather the lack of it in the Linux and FOSS communities.

To be honest I am currently about two weeks behind in my feed reading so have missed most of the comments and articles that seem to have been written on this. However, this is an area of Free Software where I think a lot can be done.

I have to say that in the 7 years I have been using Linux it's only really since I moved to Arch that I have appreciated having a good source or help and documentation. In my early days of using Linux I found the quality of help was very hit and miss. Some forums (i.e. LinuxQuestions.org) where brilliant and people would really try and help and point me in the right direction. Others leave one line comments which may make sense when you know the answer but which do nothing for those who know nothing. There is some documentation for some applications but it's usually out of date and non complete.

At the end of the day this problem is not FOSS specific. Having been a developer for nearly 10 years I have to say that it is incredibly rare for documentation to be written. The application I currently work on is a highly configurable web application with one source tree and each client having it's own configuration. We are two years into this application and have only a couple of documents covering a couple of points of the system. I am currently fighting to get them to at least add c# xml documentation comments so I can try and build some documentation using Doxygen. In previous applications I have been paid to work on we have not had any documentation written and I have fought the same battle. So this is obviously a problem that is to do with coders who seem to think that a good coder will get how it works by reading the code and users will just get it because it is obvious. However, not all users find all applications obvious.

In personal applications I have written that other people will use I have included at least a simple HTML page with a description of each menu and tool bar action and with lots of screen dumps. It works. I don't get any questions.... bug reports? yes! Errors? Oh yeah....! Questions about how to use it ... rarely.

This is an area where Linux and FOSS could take the lead. If we could start to build good quality documentation which meant my mum could install Linux and get up and running with little hassle more people would start using it. Windows applications have a standard help format and I think Linux could do with the same. My mum does not want to read man pages. Why would she? Big colourful html help files with lots of screen shots, kept up to date. Would that really be hard to do?

However, a major point that should be remembered is that, as with coders, people who contribute to FOSS do so in their own time and for little or no reward. Perhaps it is time that some of the big Linux vendors (Oracle, IBM, SuSe) ramp up the documentation effort.

KDE 4.3.4 "Cold" Is Out

KDE are pleased to announced the release of the 4 maintenance release to the KDE 4.3 release, codenamed "Cold".

KDE 4.4 Review On Polishlinux.org

This is the latest review of the next upcoming version of KDE from the guys over at Polishlinux.org. I have seen one of these balanced and fair reviews for each of the KDE 4 based releases.

As usual it covers the main changes in the up coming release.

My favourite so far is tabs within windows.

Google Chrome OS On A USB Key

An article on gettin Google Chrome OS to run from a USB key.

Microsoft Geeks On How To Code...

This is a very interesting article on the views of some of Microsoft's top developers on coding and the tools they use.

For me it has come at an interesting time as only last week my CTO was arguing the use of SQL diagrams over SQL code to get SQL Server development work done quicker. Most of us here prefer to hand code SQL as we're developers whereas he is more of a mathematical/logic type of user and prefers to see the code in diagrams.

Personally I am a keyboard and Editor type of developer. I need Vim and ViEmu for Visual Studio/SQL server and I am happy on Windows and on Linux I tend to use Konsole/Vim/GDB and now more and more Qt Creator. I prefer not to use graphical tools for anything over than UI design.

I'd be interested to find out what other people use and why?

KDE 4.4 Interview

This is a great interview detailing whats coming up in KDE 4.4 which comes out in January.

Here are some nice shinny pictures.

Chromium Browser on Arch

So new series of Spooks tonight (excellent viewing) and as I was just catching up on my feeds I noticed a thread on Google Chromium on Linux and it's speed.

Being a bit of a browser junkie I thought "I have never run it on Linux, why? It's my default windows browser". So a quick...

AurGet chromium-browser-bin

(AurGet being an excellent AUR grabbing script which I think I found on Arch Wiki)

... And I was watching a really smart installer whizzing along.

Five minutes later and I was sitting playing with Chromium. This is the open source version that Google released based on the initial Chrome browser.

My god it is fast!! As usual I set it up with Keyboardr.com and it flies. It is so fast I keep retrying things because I can't believe what I am seeing. The two things which I find I don't like is the GTK++ toolkit. I know, I know..... there is nothing wrong with it, it is just personal taste (and being a KDE only kinda guy!). The second is that I am at present unable to disable path searching. Whenever I type an address it wants to use the default search engine. I have only been playing for a 30 mins or so.