CommunityDocs ContributorHints

Revision as of 11:25, 3 June 2010 by Psunb (Talk | contribs)

Community Docs: Guidelines and hints for contributors

So you made it here in order to contribute documentation to the NetBeans Community Docs program - be heartfelt welcome here. In order to get you easily started, we collected a couple of resources and fundamental information on how the program works and how contributions should be added. We hope this will answer all your initial questions, if not, please don't hesitate contacting anyone of us with your questions and comments.

Contents


Why contribute?

There are a few good reasons to contribute documentation:

  • "Easily give something back": NetBeans IDE is an open source application with an enthusiastic community of users around the world. You don't have to be a software developer skilled in hacking the IDE's source code or spend a long time writing to contribute something. Every contribution matters whether short tips and hints or a brief guide to creating a certain type of project or configuring a 3rd party tool in the IDE.


  • "Community Recognition": As a community we show our appreciation to all those spending time and energy on sharing what they know. Who knows, your next employer may also care about your contributions to the NetBeans IDE and NetBeans RCP projects? :)

How to Contribute Docs Content

  1. Have a short tutorial, tech tip, demo, plugin guide or blogs entry to share? There are a couple ways you can share it:
* create a wiki page on wiki.netbeans.org using the http://wiki.netbeans.org/BriefTutorialOutline Tutorial Template as a guide. When you think the content is ready, send the link and announce that it's ready for review to commdocs@netbeans.org. After it has been reviewed we will add the link to the Community docs page - http://wiki.netbeans.org/CommunityDocs_Contributions
* write about it on your personal blog or DZone. When it's ready, send the link to commdocs@netneans.org and we'll add it to the community contributions list.
* Want to contribute but don't have an idea what to write about? Take a look at the community wishlist - http://wiki.netbeans.org/CommunityDocs_Wishlist  There are plenty of topics yet to be written about that could benefit from your insights and experiences using the IDE.

Discussing Contributions on our email alias and forum

There is an commdocs@netbeans.org mailing alias that links to a forum (add URL) for discussing any issues related to NetBeans IDE Community contributed documentation such as asking questions about what to contribute, how to contribute and request reviews of contribution. from other NBCD contributors. We encourage you to sign up to commdocs@netbeans.org or visit http://netbeans.org/projects/www/lists/commdocs/archive to see what's being discussed.

  1. Go to http://usersguide.NetBeans.org/servlets/ProjectMailingListList and log on with your user name. (If you don't have one, just click Login.Then you can register for one.)
  2. Scroll down to the commdocs@netbeans.org mailing list. Click subscribe and a subscription request will be sent.

Contribution formats

  • Tutorials: Teach someone how to use your plug-in, or simply show someone how to perform a task using the NetBeans IDE. You can write a whole tutorial, or send us your list of steps and best practices that you discovered, and our writers will turn them into a tutorial. We will even provide you with a tutorial template.
  • Flash Demos: Demonstrate how tasks can be performed using the NetBeans IDE. You can make a Flash demo from any existing tutorial, or create a new Flash demo. Look here to see how to create a Flash demo.
  • FAQs: Do you have the answers? Add them to the User FAQ wiki page or write a short HowTo and link it here.
  • Tips and Tricks: Share ideas and give advice to other users. 'TaT' is intended to collect small yet valuable pieces of information helping you to get out the most of your tooling in everday productive work.
  • Blogging: Asides creating documentation right here in the NetBeans Community Docs wiki, you might as well use your weblog / website / content management environment / ... for doing so. Just add the URL or permalink of your contribution to CommunityDocs_Contributions or send it to us via e-mail so we will do that for you. If you intend to contribute regularly, you might as well consider adding your blog to Planet NetBeans.
  • 'Case Stories': Did you migrate your whole development team to using NetBeans and see significant benefit from this? Did you port your internal application to use NetBeans RCP? Do you by now offer to your customers an application based upon the platform, or do you provide a NetBeans IDE tooling for your very framework? No matter what, sharing your experiences on this also is a good way of contributing to the Communiy Docs program. Asides telling the world you're using NetBeans, this kind of contribution might come in helpful to both other users eventually into adopting NetBeans for a similar purpose. And, for sure it does help us learning what users are doing with 'our' application, it helps us responding to your experiences both positive and negative and overally making NetBeans even better, making it even more the tool you just want in your everyday productive work.


Style Guide

  • Editorial Guidelines for Submitted contributions by Catherine Pawlick. Here you'll find tips on making your contribution look neater and more professional. This guide is recommended for anyone who writes technical documentation.
  • There is a reference sheet about using the wiki markup language to write structured documentation using the wiki syntax. There is also a Java plugin called WikiWizard you can use. After installation, you select "WikiWizard" from the "Editor" drop-down box at the upper right corner of your editor window.
Not logged in. Log in, Register

By use of this website, you agree to the NetBeans Policies and Terms of Use. © 2012, Oracle Corporation and/or its affiliates. Sponsored by Oracle logo