You know, one thing that I think is really keeping people from developing for the N900 more is the horrible state of the documentation. It seems to be all over the place and near unintelligible. It took me hours to find a working example of adding my own category to the contacts list. It was even a colossal pain to install the SDK itself.

Then there is the reliance on Eclipse (Which is really just a piece of trash.), the fact that the environment variables inside the scratchbox are not automatically set up to actually find libraries on their own does not help either. When you try to compile on the command-line inside the scratchbox you end up getting linker related errors and have to play around with various flags to get your code to compile. This also makes it even harder to use some other tool to write the code (I'm an Emacs guy myself.)

In short it is such an annoyance that it makes me want to avoid spending time actually writing anything for the N900 because it feels like I have to pull teeth to find what I want from the documentation and pull even more teeth to get code that is otherwise correct to actually build. I have enough problems getting stuff to work at my job, I really don't want to be bothered with platform related issues when coding in my free time. I would much rather be dealing issues related to the actual program I am writing, rather than the tools and or manuals getting in my way.

It is really a shame that the current Maemo documentation is in the state that it is in because Nokia does have people on their staff that know how to organize documentation. Even without really knowing C or C++ I can easily navigate the Qt docs and find what I am looking for in most cases. I really can't wait for the port over to Qt to be finished since that will most likely address the problem of poorly organized documentation.