Contribute to Deltacloud

Deltacloud project is a free open source software licensed under the Apache Software Foundation license. The developers community is open to anyone who wants to contribute. Contributors are required to sign an individual contributor license agreement. Do not hesitate to contact us if you have any questions about contributing to the Deltacloud project.

How can I contribute?


Overview of the Deltacloud directory structure

The following list contains paths to essential files and directories for developers. It is intended as a help with orientation in the project directory - for example to quickly identify where the Deltacloud cloud provider drivers are stored:

deltacloud
|-----------------------------------------------------------------------------------
|-d-->tests                           Contains Cucumber tests
|-----------------------------------------------------------------------------------
|-d-->site                            Files for this website
|-----------------------------------------------------------------------------------
|-d-->client                          Contains the Deltacloud ruby client
|-----------------------------------------------------------------------------------
|-d-->clients                         Contains other Deltacloud clients (e.g. java)
|-----------------------------------------------------------------------------------
|-d--> server
       |----------------------------------------------------------------------------
       |-d-->bin                      Contains the Deltacloud executable deltacloudd
       |----------------------------------------------------------------------------
       |-d-->views                    Contains haml views for each collection
       |----------------------------------------------------------------------------
       |-d-->tests                    Contains unit tests for drivers
       |----------------------------------------------------------------------------
       |-d-->lib
             |----------------------------------------------------------------------
             |-d-->sinatra            Contains rabbit DSL and various helpers
             |----------------------------------------------------------------------
             |-d-->deltacloud
                   |----------------------------------------------------------------
                   |-d-->models       Definition of each collection model
                   |----------------------------------------------------------------
                   |-d-->drivers      Contains the drivers for each cloud provider
                   |----------------------------------------------------------------
                   |-d-->helpers      Various helper methods used by the drivers
                   |----------------------------------------------------------------
                   |-d-->base_driver  Contains the Deltacloud base driver
                   |----------------------------------------------------------------
                   |-f-->server.rb                Contains the sinatra routes
                   |----------------------------------------------------------------


Reporting a bug

We track bugs in Apache JIRA. When you discover a problem with Deltacloud functionality, check JIRA if someone has already reported the issue to the Deltacloud developers. Otherwise, report it.

Proposing an idea

Have you found a way how to improve Deltacloud project? Do you miss a feature or a tool, which we could include into Deltacloud? Our Teambox page is a place where we keep the latest task lists and where you can add comments or suggest new features for the project.

Writing documentation

You can also contribute with a piece of documentation. There are still things which needs to be described. If you found one like that and you are interested in writing a couple of sentences about the particular issue, please, don’t hesitate to do it and send us your contribution. We really appreciate your help.