Quassel IRC

h1. Getting started

{{toc}}

This guide guide describes how you get involved as new developer. If you only want to contribute patches you can checkout following guide

[[Creating_Translation_git_patches]]

h2. Redmine

No source code change without an issue. Quassel project manages bugs and features with the redmine plattform. To get open issue (bug or feature) assigned, you have to setup account here on http://bugs.quassel-irc.org. 

"register here":http://bugs.quassel-irc.org/account/register

Please choose a nick is identical or similar to your irc nick.

h2. Git

Install git on your operation system and configure it.

<pre>

git config --global user.name "First name and last name"

git config --global user.email registered@email.example.com

</pre>

Optional you can switch colorful output on.

<pre>

git config --global color.diff auto

git config --global color.status auto

git config --global color.branch auto

</pre>

h2. Gitorious

h3. Setup account

"register here":http://gitorious.org/users/new

Please choose a nick is identical or similar to your irc nick.

h3. quassel clone

Setup your personal clone of quassel. Go to http://gitorious.org/quassel/quassel/clone and choose a name like yournicks-quassel.

Switch to your preferred directory for your projects like <code>/home/yournick/projects</code>. Now you can clone the personal quassel clone to your local machine. 

<pre>

git clone git://gitorious.org/~yournick/quassel/yournicks-quassel.git

</pre>

h3. ssh key

To push changes you will need a SSH key pair. To generate it on linux type the command:

<pre>

ssh-keygen -t rsa

</pre>

On Windows you can check the "official faq":http://gitorious.org/about/faq for a solution.

After following instructions, you should now have a private key like id_dsa and public key *id_dsa.pub* in your _~/.ssh/_. Upload the public key in your gitorious account options. http://gitorious.org/~yournick/keys/new

h3. ssh agent

_TODO_

h2. Workflow

_TODO_