[jboss-user] [JBoss Tools] - Howto contribute to SWTBot

[Jiri Peterka]

Jiri Peterka [http://community.jboss.org/people/jpeterka] created the document:

"Howto contribute to SWTBot"

To view the document, visit: http://community.jboss.org/docs/DOC-16702

--------------------------------------------------------------
h1. Howto contribute to SWTBot
h4. Document goal
This article should provide basic howto about contributing to  http://www.eclipse.org/swtbot/ SWTBot which is testing tools for testing SWT and Eclipse based applications like JBoss Tools. 
h4. The Process
Process of SWTBot contribution is similar as any other Eclipse Project contribution. It is composed of these steps done by a contributor(C) and main developer(D):
* (C) Finding/reporting appropriate issues in/into  Eclipse Bugzilla
* (C) Creating and attaching patch into Bugzilla record
* (D) Developer reviews the patch
* (C) Update your patch if requested
* (D) Commiting the patch into particular branch
* (D) Building new version containing your fix or a new feature
Let's take a look on particular steps in detail
h4. Finding/reporting appropriate issue
As same as the rest of Eclipse projects SWTBot records are tracked via  https://bugs.eclipse.org/bugs/ Eclipse Bugzilla. Let's assume we want to take a look on existing open SWTBot issues and feature requests to fix them later. 
* Open Bugzilla on  https://bugs.eclipse.org/bugs/query.cgi Advance Search page Advance Search
* Specify criteria       * Classification: Technology
* Product: SWTBot
* Component: Select Component which you're interested in'
* Status: Unconfirmed, New, Assign, Reopened
* Modify or add parameters as you need

*  https://bugs.eclipse.org/bugs/buglist.cgi?order=Importance;classification=Technology;query_format=advanced;bug_status=UNCONFIRMED;bug_status=NEW;bug_status=ASSIGNED;bug_status=REOPENED;component=EclipseBot;component=GEFBot;component=SWTBot;product=SWTBot Search 
* Select issue record and see details
In case bug is not know you need to create no Bugzilla record.To do it, follow these steps:
* Go to  https://bugs.eclipse.org/bugs/enter_bug.cgi?product=SWTBot&format=guided SWTBot main reporting page, login if needed
* Review once more if your issue is not already reported

Note: You'll need account on  https://bugs.eclipse.org/bugs/ Eclipse Bugzilla account to peform particular tasks 
h4. Creating a patch
For creating the patch you'will need SWTBot installed imported appropriate plugin containing the source code. The simplest way is to checkout swtbot from git repository. Minimal steps (to make it from Eclispe) to achieve this are these:
*  http://eclipse.org/downloads/ Install Eclipse 3.6 (RCP bundle would be sufficient)
* Install  http://www.eclipse.org/egit/ eGit from       http://download.eclipse.org/egit/updates http://download.eclipse.org/egit/updates 
* Clone master branch (Import ->Projects from git)  from swtbot git site (git clone      git://github.com/ketan/SWTBot.git)
* Create branch and perform code changes you have in mind
* If appropriate then add new tests for it as well
* Be sure it can be compiled without errors and 
*  http://wiki.eclipse.org/EGit/User_Guide#Creating_Patches Create patch file
* Attach patch file into Bugzilla record ("Add an attachment" link on Bugzilla record page 
* Wait for response and try to cooperate with SWTBot Developer (can take time period from days to months)
* Possible revisions could be asked here, so you might to repeat last two steps
* After that, if you're lucky, you're patch should be submitted :) accepted      and you're fix/feature will be available in the next version
Note: Beware some code in SWTBot is generated (mainly in SWT and Eclipse bot) and some not (like GEF bot)
h4. Several hints
* widely needed (see voting) patch has higher probability of      acceptance
* smaller patch has higher probability of acceptance - can be reviewed faster
* be polite and patient - you can't speed the process  with rudeness
h4. Useful links
*  http://wiki.eclipse.org/SWTBot/Contributing SWTBot      Contributing
*  http://www.eclipse.org/egit/ eGit
*  http://blog.hantsuki.org/2008/03/07/how-to-contribute-to-eclipse-projects/ Howto contribute Eclipse project
*  http://www.eclipsezone.com/eclipse/forums/t99339.html Getting started with Eclipse plug-ins
*  http://www.eclipse.org/articles/article.php?file=Article-How-to-Fix-a-Bug-in-Eclipse/index.html Howto fix bugs in Eclipse
--------------------------------------------------------------

Comment by going to Community
[http://community.jboss.org/docs/DOC-16702]

Create a new document in JBoss Tools at Community
[http://community.jboss.org/choose-container!input.jspa?contentType=102&containerType=14&container=2128]
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.jboss.org/pipermail/jboss-user/attachments/20110408/2e6399e8/attachment-0001.html