Page History

...

How does Tuscany Tune-Up work? In exchange for less than 8 hours of your time, you will be able to experience open source development and contribute to an actual product. You will be helping the Tuscany project improve by solving actual issues known as Jiras. See whether you like web development. Learn a new technology. Gain valuable experience for your resume. Get in touch with the world-wide development team. Meet and discuss issues with student mentors. Just follow the numbered steps below, marking off the steps as you complete them. If you get stuck, each section lists a live person that you can talk to via chat, email, or web cam. It's an easy way to pick up a valuable new skill. In the end we will reward you with a prize such as a commemorative pin, T-shirt, or movie tickets (NOTE: This page is a mock up. There are no prizes at this point!)

Step 1. - Get Connected

Come join the Tuscany development team. By completing this step you become a true Tuscany contributor. You gain access to the open source world of software development. This gives you access to mailing lists and our issues lists which are known as Jiras. You can think of Jiras as bugs, feature requests, or areas for improvement.

...

Complete and submit the form at https://issues.apache.org/jira/secure/Signup!\!default.jspa ^{Image Removed} .

This account gives you access to browse lists of Jiras, comment on them, and contribute patches. Check here when you are done:

...

• Haleh Mahbod (haleh@......)
• Luciano Resende (luciano@......)
• Raymond Feng (raymond@.....)
• Dan Becker (dan.becker@......)
• ...

Step 2. - Try Out Tuscany

...

Download the latest release of Tuscany to your computer. You can run Tuscany on any system that supports the programming language Java and the Java developer toolkit - Linux, MacOS, or Windows. Make a fresh directory such as Tuscany. Down load and unzip this Tuscany binary to that directory.

http://tuscany.apache.org/tuscany-downloads-documentations.html^{Image Removed}

Check here when you are done:

...

If your system does not have Java installed, you will need to install it. You can use any version of Java, but here we are using the version from Sun.

 http://java.sun.com/javase/downloads/index.jsp^{Image Removed}

Open a command window and test if your Java has installed correctly. When you type "java -version" you should see a Java version number.

...

Download and install Apache Maven for your operating system

http://maven.apache.org/^{Image Removed}

Test that Maven works by running the command "mvn -?" at the command line.

Download and install  Tigris Subversion for your operating system

http://subversion.tigris.org/^{Image Removed}

Test that subversion works by running the command "svn help" at the command line.

Download and install Eclipse for your operating system.

http://www.eclipse.org/^{Image Removed}

Start Eclipse from you desktop and check that you get a welcome screen.

...

For more help, see the Tuscany Getting Started guide at http://tuscany.apache.org/getting-started-with-tuscany-using-the-command-line.html

Check here when you are done:

Image Added

Trouble with this Step?

Contact these Mentors:

• Haleh Mahbod (haleh@......)
• Luciano Resende (luciano@......)
• Raymond Feng (raymond@.....)
• Dan Becker (dan.becker@......)
• ...

Step 3 - Find a Tuscany Issue to Solve

Now that we can run Tuscany, it is time to find an true issue to solve. We need to set up a debugger and recreate the issue in order to solve it.

Estimated time for this step: 1 hour

A. Pick a Jira

Visit the Tuscany Tune Up issue list at http://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12310210&status=1

These issues have been screened by the Tuscany development team to ensure that they can be recreated and fixed by an experienced developer in less than 4 hours. If it takes you longer, don't worry. You are cramming lots of learning and exploration into this process as well, so it is no problem if it takes longer.

Once you have selected a issue that interests you, put a comment on it to let other developers know you are investigating. Comment on each stage of your progress

1. I am investigating this Jira.

2. I have recreated this issue.

3. I have found the problem and am developing a patch.

Check here when you are done:

Image Added

B. Recreate the Jira issue

Is the problem recreatable? Can you see the issue? Has the Jira originator left out steps? Contact the originator if you cannot see the problem. Ask questions in the developer list.

Check here when you are done:

Image Added

Trouble with this Step?

Contact these Mentors:

• Haleh Mahbod (haleh@......)
• Luciano Resende (luciano@......)
• Raymond Feng (raymond@.....)
• Dan Becker (dan.becker@......)
• ...

Step 4. Get Ready to Debug!

Let us set up a debugging environment to help fix the problem.

Estimated time for this step: 2 hours

A. Download the Tuscany Code Base

Show using subv=sersion to download the trunk or a recent branck.

Run maven on a sample to ensure the code builds

Check here when you are done:

Image Added

B. Get the Debugger Ready

Show setting up Eclipse and debugging a sample or two in the debugger.

http://tuscany.apache.org/getting-started-with-tuscany-using-tuscany-eclipse-plugin.html 

Check here when you are done:

Image Added

 C. Recreate Your Problem in the Debugger

Recreate your problem using the code in your debugger.

Check here when you are done:

Image Added

Trouble with this Step?

Contact these Mentors:

• Haleh Mahbod (haleh@......)
• Luciano Resende (luciano@......)
• Raymond Feng (raymond@.....)
• Dan Becker (dan.becker@......)
• ...

Step 5. Propose a Solution

 In this step you must develop and find code to fix the problem.

Estimated time for this step: 2 hours

A. Create a Patch

Show how to create and append a patch file to the Jira.

Check here when you are done:

Image Added

B. Get a Review

One of the following mentors will review your patch and provide feedback. If the patch is not accepted, specific reasons why it could not be used are provided. If it can be used, it will be commited to that branch of the code.html^{Image Removed}

Check here when you are done:

Trouble with this Step?

Contact these Mentors:

• Haleh Mahbod (haleh@......)
• Luciano Resende (luciano@......)
• Raymond Feng (raymond@.....)
• Dan Becker (dan.becker@......)
• ...

Step 6.  Pick Up Your Tuscany Tune Up Prize

(NOTE: There are no prizes. This page is just a mock-up. No prizes are available.)

But this is not the end of the journey. Use your Tuscany Tune Up exerience to continue participation in the online community. Don't forget to include your experience on your resume. Tackle another Jira. Collaborate with other developers.