Title: Development

This site documents development related issues when working with the Apache Stanbol source code and contributing to it.

Everything has to be discussed on the developer [mailing list](#mailing_lists) prior to any
implementation action. If it is not on the list, it did not happen.

New features should be backed by [JIRA issues](#issue_tracking) that describe the goals,
use cases and software design decisions, which are usually the result 
of dev list discussions. It is much easier to refer to JIRA issues describing 
the implementation details for further discussions and later reference. 

The developers list is not a good place for persistent information, but JIRA issues 
can also be used as an initial form of [documentation](#documentation) for new 
features: add usage and test instructions to the JIRA issues once your features
reaches a usable state, so that others can test them. This is a good way of
evolving the features documentation, as you work on the implementation.

<a name="mailing_lists"></a>
## Mailing Lists

The Apache Stanbol projects uses mailing lists to exchange all relevant information. If something was not mentioned and discussed on the mailing list it did not happen.

The developer mailing list is where the action is, so make sure you subscribe to the Apache Stanbol developers mailing list. Details on how to subscribe are given in the lists overview below.

We don't have a users mailing list at this time, we'll create it if traffic becomes too high on the dev list. User questions are welcome on the dev list for now.

Mailing list archives are available at [mail-archives.apache.org](http://mail-archives.apache.org/mod_mbox/), [stanbol.markmail.org](http://stanbol.markmail.org).

#### Lists Overview

<table width="80%">
<theader>
<tr>
  <th>Name</th>
  <th>Subscribe via</th>
  <th>Unsubscribe via</th>
  <th>Postings to</th>
  <th>Archives</th>
</tr>
</theader>
<tbody>
<tr>
  <td>Stanbol Developer List</td>
  <td><a href="mailto:dev-subscribe@stanbol.apache.org">subscribe</a></td>
  <td><a href="mailto:dev-unsubscribe@stanbol.apache.org">unsubscribe</a></td>
  <td><code>dev AT stanbol.apache.org</code></td>
  <td>
    <a href="http://mail-archives.apache.org/mod_mbox/stanbol-dev">mail-archives.apache.org</a>,<br />
    <a href="http://mail-archives.apache.org/mod_mbox/incubator-stanbol-dev">mail-archives.apache.org (incubation)</a>,<br />
    <a href="http://stanbol.markmail.org/search/?q=+list%3Aorg.apache.incubator.stanbol-dev">stanbol.markmail.org</a></td>
  </td>
</tr>
<tr>
  <td>Stanbol Private List<br />(for <a href="../pmc/">PMC members</a> only)</td>
  <td><a href="mailto:private-subscribe@stanbol.apache.org">subscribe</a></td>
  <td><a href="mailto:private-unsubscribe@stanbol.apache.org">unsubscribe</a></td>
  <td><code>private AT stanbol.apache.org</code></td>
  <td></td>
</tr>
<tr>
  <td>Stanbol Source Control</td>
  <td><a href="mailto:commits-subscribe@stanbol.apache.org">subscribe</a></td>
  <td><a href="mailto:commits-unsubscribe@stanbol.apache.org">unsubscribe</a></td>
  <td></td>
  <td>
    <a href="http://mail-archives.apache.org/mod_mbox/stanbol-commits">mail-archives.apache.org</a>,<br />
    <a href="http://mail-archives.apache.org/mod_mbox/incubator-stanbol-commits">mail-archives.apache.org (incubation)</a>,<br />
    <a href="http://stanbol.markmail.org/search/?q=+list%3Aorg.apache.incubator.stanbol-commits">stanbol.markmail.org</a></td>
  </td>
</tr>
</tbody>
</table>

<a name="issue_tracker"></a>
## Issue tracker

The Apache Stanbol issue tracker is at [https://issues.apache.org/jira/browse/STANBOL](https://issues.apache.org/jira/browse/STANBOL). You can report issues and submit patches there, and you're welcome to discuss those on the mailing list first, as needed.

<a name="documentation"></a>
## Documentation

For a first documentation starting with JIRA issues that describe what you're doing and 
how to use and test it is often good enough, and it's a good way to document things
as you go.

Once new features reach a somewhat stable state, it's good to
[document them on the website](website.html).

<a name="source_code"></a>
## Source Code

The Apache Stanbol [source code](https://svn.apache.org/repos/asf/stanbol/trunk/) can checked out via Subversion from

    https://svn.apache.org/repos/asf/stanbol/trunk/ 

<a name="development_practices"></a>
## Development Practices

The following documents describe the software development practices that are
followed by the Apache Stanbol project.

  * [Dependency Management](dependency-management.html)
  * [Coding Standards](coding.html)
  * [Security Aware Coding](security.html)
  * [Release Management](release-management.html)