Development

OpenRelay is under active development, and contributions are welcome.

Source Control

The OpenRelay source is managed with Git

The project is publicly accessible, hosted and can be cloned from GitHub using:

$ git clone git://github.com/Captainkrtek/OpenRelay.git

Git branch structure

OpenRelay follows the model layout by Vincent Driessen in his Successful Git Branching Model blog post. Git-flow is a great tool for managing the repository in this way.

development
The “next release” branch, likely unstable.
master
Current production release (0.3).
feature/<feature-name>
Unfinished/ummerged feature.

Each release is tagged and available for download on the Downloads section of the OpenRelay repository on GitHub.

When submitting patches, please place your feature/change in its own branch prior to opening a pull request on GitHub. To familiarize yourself with the technical details of the project read the internals section.

Getting Involved

OpenRelay, as mentioned earlier, is under active development. If you’re interested in getting involved, clone the repo and send us a pull request with your update. If you’re interested in becoming a maintainer, email steve@peer.to with your qualifications.

Documentation

The documentation is written in reStructured Text format.

The documentation lives in the docs directory. In order to build it, you will first need to install Sphinx.

$ pip install sphinx

Then, to build an HTML version of the documentation, simply run the following from the docs directory:

$ make html

Your docs/_build/html directory will then contain an HTML version of the documentation, ready for publication on most web servers.

You can also do a recursive wget of http://peer.to/docs to obtain the latest documentation build of OpenRelay

$ wget -r http://peer.to/git/docs/_build/html/

Then navigate to the _build/html directory and open index.html in your browser to browse the documentation.

You can also generate the documentation in format other than HTML.

Project Versions

Table Of Contents

Previous topic

Settings

Next topic

Changelog

This Page