| Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision |
| contribute:start [2014/11/24 11:07] – [Contribute] nick | contribute:start [2019/04/08 23:44] – [Bug Reporting and Testing] blueberrybrownie |
|---|
| ====== Contribute ====== | |
| |
| [[.:translate/start|Translate]]\\ | ====== How to Contribute ====== |
| Translate the source code of Xfce. | Xfce is developed by a small group of hard-working volunteers. There are many ways in which you can contribute to Xfce, all of which are most welcome! |
| |
| [[documentation|Documentation]]\\ | ===== Translation ===== |
| How to start writing or translate the application manuals on this website. | Applications, manuals, documentation and many other aspects of Xfce are all translated into different languages. Translations are handled in [[https://www.transifex.com/xfce/public|Transifex]], a web-based translation platform. Visit the [[.:translate/start|translation docs]] to get started with translating. |
| |
| [[.:bugs/start|Bugs]]\\ | ===== Donations ===== |
| All there is to know about properly reporting bugs in the [[https://bugzilla.xfce.org|bug tracker]]. | If you wish to donate to Xfce, you can do so via [[https://www.bountysource.com/teams/xfce|Xfce’s Bountysource page]]. You can freely donate to the organization itself, or offer a reward to fix a specific bug. Every donation is greatly appreciated, but please remember, this is an open source project that is 100% run by volunteers, no one is implicitly obliged to act upon your requests. |
| |
| [[.:dev/start|Development]]\\ | {{https://www.bountysource.com/badge/team?team_id=849&style=raised&.jpg?}} |
| How to contribute code and becoming a developer. | |
| |
| [[https://www.bountysource.com/teams/xfce|{{https://www.bountysource.com/badge/team?team_id=849&style=raised&.jpg?}}]]\\ | ===== Bug Reporting and Testing ===== |
| To support the Xfce project or making it more attractive to get things done, you can back the project with bounties on bugs or leave it up to the developers to decide what to do. | One of the most useful tasks that we rely on the community for is testing and reporting of bugs. You can report bugs on the [[https://bugzilla.xfce.org/|Xfce Bugzilla site]], the [[https://mail.xfce.org/mailman/listinfo/xfce-bugs|Xfce-bugs mailing list]], or you can ask on our IRC channel [[irc://irc.freenode.net/#xfce|#xfce on Freenode]] for help. Please do not use the forums to report bugs. Before submitting a bug, please try your best to check if it has already been reported. When writing your bug report, try to be as descriptive as possible, but avoid verbosity. Mozilla has a nice guide on [[https://developer.mozilla.org/en-US/docs/Mozilla/QA/Bug_writing_guidelines|how to write a bug report]]. For more information, refer to [[.:bugs/start|Bug Reporting and Fixing]]. |
| |
| ===== API documentation ===== | ===== Documentation ===== |
| | The [[https://wiki.xfce.org/|Xfce Wiki]] and [[https://docs.xfce.org/|Documentation]] contain many helpful pages that require maintaining and updating with every new release. The wiki is freely available for anyone to edit, refer [[documentation|here]] for information on how to contribute to the documentation. |
| |
| Library references can be found in the releases: [[http://archive.xfce.org/src/xfce/garcon|garcon]], [[http://archive.xfce.org/src/xfce/exo|exo]], [[http://archive.xfce.org/src/xfce/libxfce4ui|libxfce4ui]], [[http://archive.xfce.org/src/xfce/libxfce4util|libxfce4util]], [[http://archive.xfce.org/src/xfce/thunar|thunar]], [[http://archive.xfce.org/src/xfce/xfconf|xfconf]]. They are often also installed by distributions in ''/usr/share/gtk-doc/html/''. | |
| |
| Additionally, Xfce uses the GTK+/Glib family of libraries which can be found at the following: | ===== Get in Touch ===== |
| |
| * [[https://developer.gnome.org/glib/2.30/|GLib]] | Before starting contribution it may make sense to get in contact with some xfce experts: |
| * [[https://developer.gnome.org/gio/2.30/|GIO]] | |
| * [[https://developer.gnome.org/gdk2/2.24/|GDK]] | |
| * [[https://developer.gnome.org/gtk2/2.24/|GTK+]] | |
| |
| Tutorials for getting started with GTK+ are available at: | * via **[[https://en.wikipedia.org/wiki/Internet_Relay_Chat|IRC]]**: Join #xfce and #xfce-dev on Freenode |
| | * via some **[[https://mail.xfce.org/mailman/listinfo| Xfce mailing list]]** - first check if the list is still active ! |
| |
| * [[http://zetcode.com/tutorials/gtktutorial/|GTK+ Tutorial]] | It as well might help to check the current roadmap in the **[[https://wiki.xfce.org/|Xfce development Wiki]]** in order to get an overview on ongoing development. |
| * [[https://developer.gnome.org/gtk-tutorial/2.24/|GTK+ 2.0 Tutorial (Official)]] | |
| |
| If you're looking at writing a panel plugin, you may want to look at the [[http://git.xfce.org/panel-plugins/xfce4-sample-plugin/|xfce4-sample-plugin]] for an easy start. | |
| |