This project is split in 3 parts :
  - Cairo-Dock-Core (the minimal - https://launchpad.net/cairo-dock-core)
  - Cairo-Dock-Plug-ins (a collection of views, applets, animations, effects, etc. - https://launchpad.net/cairo-dock-plug-ins)
  - Cairo-Dock-Plug-ins-Extras (a collection of third-party applets written in any language - https://launchpad.net/cairo-dock-plug-ins-extras)
The Cairo-Dock-Session project aims to provide an easy way to install a session that is desktop agnostic and uses Cairo-Dock as a Shell (the main interface).

=== INSTALLATION ===

Please see our wiki for an excellent installation guide : http://www.glx-dock.org/ww_page.php?p=By%20distributions&lang=en
Tarballs of the sources are available at : https://launchpad.net/cairo-dock-core and https://launchpad.net/cairo-dock-plug-ins
A stable ppa is available here : https://launchpad.net/~cairo-dock-team/+archive/ppa
You can easily get the cutting-edge version of Cairo-dock thanks to our weekly-build repository :
  - for Ubuntu users : https://launchpad.net/~cairo-dock-team/+archive/weekly
  - for Debian users : https://launchpad.net/~cairo-dock-team/+archive/weekly-debian

=== NEED SOME HELP ? ===

See our wiki ! http://www.glx-dock.org/ww_page.php
You can find : how to launch the dock at startup, how to customise it, how to resolve some recurrent problems (black background, messages at startup, etc.) , how to help us, who we are, etc.
A useful tutorial is also available to help you customize your dock : http://www.glx-dock.org/ww_page.php?p=Tutorial-Customisation&lang=en

If you have other questions not solved on our wiki you can post them on our forum (in english or french) : http://www.glx-dock.org/bg_forumlist.php

=== JOIN THE PROJECT ! ===

* Want to HACK into the dock or write an APPLET ? see the complete C API here : http://doc.glx-dock.org
* You don't like C and still want to write an APPLET for the dock or CONTROL it from a script or the terminal ? see its powerful DBus API here : http://www.glx-dock.org/ww_page.php?p=Control_your_dock_with_DBus&lang=en
* You have some IDEAS / PROPOSITIONS ? You need some help to develop an applet ? Feel free post a topic on our forum ! We'll be happy to answer you !
* You want to TRANSLATE Cairo-Dock in your language ? Use the 'Translations' tab in Launchpad, it's very simple to use it and helpful for us !

=== BUG REPORTS ===

You can report bugs in Launchpad under the 'Bugs' section. If possible :
 * Read our wiki : specially the 'Recurrent Problems' section : http://www.glx-dock.org/ww_page.php?p=Recurrents%20problems&lang=en (which can help you to resolve some bug like a black background, messages at startup, etc.)
 * Please include also some information like your distribution, your achitecture (32/64bits), your Desktop Manager (Gnome, KDE, XFCE,...) your Window Manager (Compiz, Metacity, Kwin, etc.), if you use Cairo-Dock with or without OpenGL, with which theme, etc.
* Include the method to reproduce the bug (which actions, which options activated)
* Run the dock with the command
          cairo-dock -l debug > debug.txt
       reproduce the bug and join the content of debug.txt.
* If it's a crash and you know how to use a debugger (like ddd), it's extremely helpful.

Thanks for your help !

PS : for any bugs in BZR (alpha or beta release), please post them on our forum ! http://www.glx-dock.org/bg_forumlist.php