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

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... 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... 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&am...]