Scout/Contribution

Draft Content
This page is currently under construction. Community members are encouraged to maintain the page, and make sure the information is accurate.

Introduction

The Eclipse wiki gives a good detailed overview of the various ways you can contribute to a project:

The typical contributor will go through the following steps:

1. You use Scout, i.e. The Scout documentation has been moved to https://eclipsescout.github.io/. it, go through The Scout documentation has been moved to https://eclipsescout.github.io/., build your own Scout apps
2. You will find bugs, or have ideas for your great feature.
3. You provide some public feedback
   1. Read/ask questions on the Scout Scout Forum
   2. Report these bugs/enhancements via Scout bugzilla
4. Eventually, you might want to speed up bug fixing by providing patches
5. Getting enthusiastic enough, you will contribute many valuable, high quality patches for Scout bugs/enhancements
6. Now is the time to start the committer election process :-)

Opening new Bugs

1) Before you do anything related to searching / opening Scout bugs you might want to have a look at the Eclipse Bugzilla FAQ.

2) Before you open a new bug, please try to scan through the known bugs to verify that you are not reporting a bug that is already known for Eclipse Scout.

For your convenience a number of links are provided below:

• All open Scout bugs
• All Scout bugs

When you cannot find an existing bug, feel free to open a new bug:

Open a new Scout bug

Below there are some Scout specific guidelines on how to provide valuable information together with your bug summary

Choose the proper Component

Select the component according to the following criteria

• Scout: Scout Runtime bugs, or anyting else that you are not sure what component to choose
• Scout SDK: Bugs in the Scout SDK, e.g. wizards that create code that won't compile
• Scout Docs: Bugs on www.eclipse.org/scout, wiki.eclipse.org/scout, and any other public communication regarding Scout

Use a decent Summary line

bla

Development IDE Configuration

Scout has Java 5.0 and Eclipse Platform 3.5 as minimum requirements, so dependencies to newer Java and platform versions must be avoided.

In order to minimize the inadvertent introduction of dependencies to Java 6.0, add both a Java5 and a Java 6 SDK to your workspace. Do this in Window/Preferences -> Java/Installed JREs. Then configure your Execution Environments so that J2SE-1.5 refer to a Java 5 SDK and JavaSE-1.6 refer to a Java 6 installation.

If you are using OS X Snow Leopard, then Java 5 is hard to find. Using the search button in Eclipse will tell you that you have a 1.5.0 version of Java. That is probably a lie. It is just a link to 1.6. Fortunately some nice guys have made a download that you may use. Follow these instructions to download and installl a real Java 5. You do not need to make it default. Downloading, unpacking and fixing the version links is enough.

Getting the Scout Sources

You may download the Eclipse Scout sources from eclipse.org

 http://dev.eclipse.org/svnroot/technology/org.eclipse.scout/

Contributing Patches

Please create a Bugzilla entry with a patch attached.