This is the first time, I thought of filing an issue for NetBeans Community Docs Program as I have never ever thought there would be a need for it, in the past 2 years. Generally, no one has ever done that, AFAIK.
I have been an active contributor to NetBeans Community Docs Program and managed it as coordinator for the duration of 11 months (May ’08 – Mar ’09). However, I feel there’s lack of coverage of the resources, that are gathered and arranged in the form of several wikis interrelated with each other in a systematic way.
Through this issue, I would like to see increased presence of NetBeans Community Docs in the NetBeans Community. I have some ideas which I would like to put forward, but first I want to see interest from your side (Community Members and NetBeans Team).
You’re welcome to add your comments/suggestions or even vote for this issue. See the following for latest updates.
Jul 14, 2009
Kristian Rink has setup a user survey. Please go and fill up the forms. We need your feedback, so that we can be in better position to decide the future of this program.
Jul 08, 2009
Kristian Rink has written a post discussing the future of the program and what does the community think about it? I feel you must go through it once.
Jul 03, 2009
Since VOC Captains have CC’ed themselves on issue report and I got reply from Michel. Here are I am sharing my ideas and related details;
There are over 300 docs, right? When we reached 250 docs, I realized that there was findability issue. If I need a tutorial on how to make use of some feature, which is documented only by a community member and not by Sun writers. Then, user has to put some effort to locate that. Even I had that problem.
So, through mutual agreement, we created several category-specific wikis that would archive docs belonging to those categories. You may read more about that here;
This way we were able to fix the findability issue, temporarily. Yes, temporarily! I thought, we were still missing a page which can provide pointers to all the sections of these category-specific wikis. So, I decided to setup a wiki;
that will do the needful. Now, if anyone wants (community contributed) tutorials on GUI Builder, just need to bookmark this link;
This contains a matrix which has necessary pointers to tackle the issue.
Now, coming to the point of concern, i.e. the NetBeans Community Website doesn’t feature pointers to these wikis. As you might know that currently there’s only one pointer to the Community Docs Contributions list from relevant Learning Trails.
Instead, I would love to see a separate “Community Contributed Docs” Learning Trails, where one can have relevant information on how to access these wikis. Also, I would request the NB Team remove the following webpage;
Its better to have single Learning Trails page to focus on the above issue, rather than maintaining small sections on every Learning Trail and maintaining the above webpage. It will also ease the work spent by NB Team on such maintenance. Also, the proposed Learning Trail can also be pointed from User FAQs, Developer FAQs, etc.
If someone is unable to find necessary info in these FAQs, then he/she may navigate to the trail to learn how to find out community contributed docs for their requirement. This should be good enough to make our presence felt in the community, as this Learning Trails would feature in Docs & Support page.