Instructions for Developers and Contributors

Table of Contents

Contributing to Mira

Viewing Mira's Source Code

You can view the source code in Mira's Bazaar repository using our web-based Bazaar browsing system, powered by loggerhead.

Setting Up Your Programming Environment

If you wish to build Mira from its source code and perhaps work on it, you will need to set up your programming environment accordingly. Please see our instructions on which software and libraries to install for either Windows or Linux.

Getting Mira

To download the latest version of Mira you will need to use a program called Bazaar (bzr). If this program is not already installed and the instructions below fail for you, please see our guide on installing Bazaar.

If you are using Linux or a UNIX-based Operating System, run the following commands from a terminal window:

mkdir ~/mira
cd ~/mira
bzr branch lp:mira

If you don't want to check out the whole revision history (which will make the check out *much* faster) you can add the following parameter to the end of the above bzr command:

--lightweight

Now, to build the latest version of the Mira Client, run the following commands:

cd ~/mira/trunk/mira-client/
./configure
make
./miraclient

Or, to build the latest version of the Mira Server, run the following commands:

cd ~/mira/trunk/mira-server/
./configure
make
./miraserver

Testing Mira

Please read our testing process instructions for information on how Mira's developers conduct tests on the project's code.

To check the current list of bugs, please see our bug tracker. To submit a bug report, please first check that the bug you wish to submit is not already known and, if it is not, then we would appreciate it if you could report it in as much detail as possible.

Hacking on Mira

If you wish to contribute code or patches to Mira's client or server you must first complete and submit our Individual Contributor Licence Agreement form. This does not apply to the development of Mira Utilities, the documentation for which can be found here.

Once you have completed this form, you will be granted commit access to Mira's repository and be able to check in patches and code. Please note that your code will be moderated in a review process to judge whether it should be accepted into the stable version of Mira.

Coding Standards

Mira's developers follow a selection of coding guidelines in order to maintain consistency throughout the source code. If you wish to contribute to Mira - and would like us to merge your contribution with the project's code as soon as possible - it is thoroughly advisable to follow our coding standards, whose text is available here.

Communicating with the Developer Community

Internet Relay Chat (IRC) Channel

Mira has registered the #mira channel on the FreeNode.net network. To connect to the network, use an IRC client such as xChat (Linux), mIRC (Windows) or Colloquy (Mac OS X).

If you would like to discuss some code which you have written, or perhaps an aspect of Mira's development or a feature which you would like to see implemented in Mira then please do not hesistate to join our IRC channel!

We have scheduled IRC sessions to discuss certain development topics. These sessions are all archived for future reference.

Forums

Mira also has discussion forums on which the developers discuss the more static components of Mira which require their comments to be stored for the near future, such as design and architecture decisions. Mira's developers also conduct polls on the discussion forums regarding Mira's development and the general user experience.

To take part in the discussions please register an account.

Mailing Lists

Another discussion medium which some prefer to the forum is Mira's development mailing list, and you'll probably find that most of the active discussions are conducted on the mailing list but the final decisions are announced on the discussion forums.

To subscribe to Mira's development mailing list, please visit this website and follow the instructions: Mira-Development mailing list

If, on the other hand, you would just like to hear announcements when a new version of Mira is announced or a milestone is achieved, please subscribe to Mira's Notification List instead.

Skype

Our developers also use the proprietary Voice over IP and Instant Messaging client Skype from time to time to have conference calls to discuss features which all of the developers must be absolutely clear about, or just to have a casual chat whether the topic of focus is Mira or not.

We also archive our notes from the conferences for future reference.

 
development/instructions.txt · Last modified: 2008/06/22 03:04 by j_k9
 
Recent changes RSS feed Creative Commons License Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki