Community Docs and NetBeans

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;

Brief History

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;

http://nb-community-docs.blogspot.com/2008/11/netbeans-community-docs-reloaded.html

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;

http://wiki.netbeans.org/NBCDMatrix

that will do the needful. Now, if anyone wants (community contributed) tutorials on GUI Builder, just need to bookmark this link;

http://wiki.netbeans.org/NBCDMatrix#section-NBCDMatrix-SwingGUIBuilder

This contains a matrix which has necessary pointers to tackle the issue.

Ideas

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;

http://www.netbeans.org/community/commdocs.html

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.

Thanks!

About these ads

3 thoughts on “Community Docs and NetBeans

  1. Dear Nischal Varun, I am retired, enjoying learning Java on NB.
    I am studying MySQL to develop a database of the various files on NB, Java, JavaFX, Swing, Groovy, Grails, and on and on.
    The planned use is to query for files that contain content on the topics of interest to list the file names with thier locations
    in the folders I have stored them in.
    A potential problem appears to be the filenames are rather long so that column will be rather unwieldy.
    I am currently studying MySQL Developer’s Library by Paul DuBois, Addison Wesley Publisher.
    My first table I plan to have an Index, Filename,Location, Date, Source, pages.
    The second table would be Index number, categories.
    The database design is so important to make it relational so
    I will not have duplicate files listed nor have to have them duplicated in flat files like I currently have.
    I feel that this is not exactly what you want but that it is close.

  2. Hi Richard,

    Thanks for your interest in NetBeans. However, I don’t think that’s going to help resolve the issue. I have shared my ideas over the issue report. You may read it if you like for more details on this post and probably have a better idea of the problem in hand.

    Good luck for your project.

    Regards.

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s