I hope this is an appropriate forum to make a suggestion to Nokia S60 and Symbian Developer Support teams...
In my opinion, the current Symbian OS and S60 C++ SDK developer documentation and API reference are hard to use. Method descriptions are often very short or totally missing and there are no usage examples on the same page as the API reference.
It would be really useful to have real working source code examples connected to each class and method description directly in the API reference or at least to have a link to sample sources somewhere else.
If Symbian developer documentation would be better, more application development could be done for Symbian OS instead of Linux and Microsoft mobile platforms. The Symbian developers would be more productive and get their quality applications finished quicker.
At present Microsoft has far better developer documentation and tools compared to Symbian. I am not so familiar with Linux, but I think as it is an open source platform, the need for thorough API documentation is not so important there.
Nokia has ported the Symbian SDK documentation into many formats and integrated it into many IDEs, but still the documentation contents has remained almost the same. The usage examples are still missing and the API descriptions are poor. The sample applications are very useful, but they are not tightly connected to the API documents.
My idea is the following:
How about putting the API reference documents online and leave coders themselves add comments, samples and usage hints to the documentation? A kind of similar idea than the Wiki, the free encyclopedia in the net.
I like the way PHP and MySQL have organized their online documentation. They have "User Contributed Notes" connected to the description of each function call. There is "add a note" link, where the readers can submit their own notes. Many of the notes and comments there contains very useful code examples, configuration notes and other experiences.
I think similar interactive online SDK documentation for S60 would be a fast and efficient way of making the Symbian development easier and more attractive to the developers.
This discussion forum is very good and I have found solutions to many Symbian development problems from here. But it requires lot of time consuming searching and it is difficult to guess the right search keywords before you know the API name. (Maybe I cannot utilize all the power of the Advanced Search.)
Hope that the Symbian OS and S60 API reference gets better soon in a way or another and we get example codes connected to each API
With best wishes,