| Next revision | Previous revision |
| contribute:start [2014/03/05 13:35] – created nick | contribute:start [2026/01/31 18:31] (current) – Add links to transaction records. Bold Highlight donation statement kevinbowen |
|---|
| ====== Contribute ====== | ~~NOTOC~~ |
| | {{ :xfce-64x64.png?nolink|}} |
| | ====== How to contribute to 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! |
| |
| [[.:translate/start|Translate]]\\ | For a more in-depth look at how to contribute to Xfce, it is recommended to read [[https://andreldm.com/2018/12/03/xfce-contributor-guide.html|The Ultimate Contributor's Guide to Xfce]] for additional helpful information. |
| Translate the source code of Xfce. | |
| |
| [[documentation|Documentation]]\\ | If you would like to donate to Xfce, please see the [[start#Financial Contributions|Donations]] section. |
| How to start writing or translate the application manuals on this website. | |
| |
| [[.:bugs/start|Bugs]]\\ | * **[[#Bug Reporting and Testing|Bug Reporting and Testing]]** |
| All there is to know about properly reporting bugs in the [[https://bugzilla.xfce.org|bug tracker]]. | * **[[#Communication|Communication]]** |
| | * **[[#Development|Development]]** |
| | * **[[#Documentation|Documentation]]** |
| | * **[[#Financial Contributions|Financial Contributions]]** |
| | * **[[#Feature Requests|Feature Requests]]** |
| | * **[[#Translation|Translation]]** |
| |
| [[.:dev/start|Development]]\\ | ---- |
| How to contribute code and becoming a developer. | |
| | ===== Bug Reporting and Testing ===== |
| | |
| | One of the most useful tasks that we rely on the community for is testing and reporting of bugs. |
| | |
| | * You can report bugs on [[https://gitlab.xfce.org/|Xfce GitLab site]] |
| | |
| | * You can ask for help on [[https://docs.xfce.org/contribute/dev/start#communication_with_the_xfce_development_team|various channels]]. |
| | |
| | * 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, see [[.:bugs/start|Bug Reporting and Fixing]]. |
| | |
| | |
| | * For a list of currently open bugs, see the [[:contribute:bugs:bug-summary|open bugs summary]]. |
| | |
| | If you want to test the current state of Xfce 4.16, you can look at the [[https://wiki.xfce.org/testing/xfce-test|Xfce-Test Quick Start Guide]], which provides instructions for running a Docker container with the lastest code from git master as well as the ability to run [[https://github.com/behave/behave|Behave]] (behaviour-driven development) tests. |
| | |
| | * As of November 2020, OpenSUSE is now providing a source for "Xfce’s latest builds based on openSUSE’s rolling release Tumbleweed". This is available as a QEMU based virtual machine. |
| | * [[https://news.opensuse.org/2020/11/23/xfce-raw-images/|Xfce Virtual Machine Images For Development]] provides additional information for its installation and bug reporting instructions. |
| | |
| | ---- |
| | |
| | ===== Communication ===== |
| | There are various ways to get in touch with Xfce developers: |
| | |
| | See the [[https://docs.xfce.org/contribute/dev/start#communicating_with_the_xfce_development_team|Xfce Development Information]] page for information on contacting the Xfce development team. |
| | |
| | ---- |
| | |
| | ===== Development ===== |
| | |
| | See the [[:contribute:dev:start|Xfce Development Information]] page for details on getting a contributor's account, working with Git and Xfce source code, and instructions for making releases. |
| | As well check the [[https://wiki.xfce.org/|Xfce Wiki]] more development hints, tips and tricks. |
| | |
| | ---- |
| | |
| | ===== Documentation ===== |
| | |
| | The [[https://docs.xfce.org/|Xfce Official Documentation]] and the [[https://wiki.xfce.org/|Xfce Developer's Wiki]] contain many helpful pages that require maintaining and updating with every new release. The wiki is freely available for anyone to edit, refer to the [[documentation|Xfce Documentation Guidelines]] for information on how to contribute to the documentation. |
| | The [[https://developer.xfce.org/|Xfce API reference]] is automatically updated on a weekly basis based on the latest stable releases. |
| | |
| | ---- |
| | |
| | ===== Financial Contributions ===== |
| | |
| | As of May 2021, Xfce has moved its fiscal hosting to OpenCollective. We are now able to accept financial contributions in both US Dollars as well as Euros. |
| | If you wish to donate to Xfce in USD or with PayPal, you can do so by visiting [[https://www.opencollective.com/xfce/donate|Xfce’s OpenCollective page]]. Alternatively, if you wish to contribute in Euros, visit [[https://www.opencollective.com/xfce-eu/donate|Xfce’s EU OpenCollective page]]. 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. |
| | |
| | For contributions in USD (SWIFT transfers / PayPal / credit card): |
| | |
| | [[https://opencollective.com/xfce/donate|{{:contribute:oc_donate_button30px.png}}]] |
| | Note: For financial contributions to the Xfce Collective, there is a 10% transaction fee. |
| | |
| | For contributions in EUR (SEPA transfers / credit card): |
| | |
| | [[https://opencollective.com/xfce-eu/donate|{{:contribute:oc_donate_button30px.png}}]] |
| | Note: For financial contributions to the Xfce (EU) Collective, there is a 6% transaction fee. Additionally, SEPA transfers may take several business days to process and will not appear in the transaction records immediately. |
| | |
| | In the interest of transparency, records of individual transactions can be viewed here: |
| | * [[https://opencollective.com/xfce/transactions|Individual transaction details]] for Xfce(USD) Collective |
| | * [[https://opencollective.com/xfce-eu/transactions|Individual transaction details]] for Xfce(EU) Collective |
| | |
| | ** |
| | This is a donation. No goods or services are expected in return. Any requests for refunds for those purposes will be rejected.** For additional details, see [[https://wiki.xfce.org/finance/open-collective|Xfce financial contribution administration - Open Collective]] |
| | |
| | ---- |
| | |
| | ===== Feature Requests ===== |
| | |
| | Although the philosophy of Xfce is to find the correct balance between features and lightweight, it is still possible to request new features. |
| | |
| | If you plan to request a new feature, please first check on our [[https://gitlab.xfce.org/xfce|issue tracker]] if someone else already filed a request for it. If not, open a new issue and describe your idea in detail. Be warned: You might think your idea is brilliant, but there is a high possibility that there are major downsides. |
| | |
| | Obviously, the best way to get your new feature integrated is, to provide a merge request that implements it ! |
| | |
| | Please note that some components are rather unmaintained, so you might not always get a reply. |
| | |
| | ---- |
| | |
| | ===== Translation ===== |
| | |
| | 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. |
| | |
| | [[|Back To Top]] |
| | ---- |
| | [[:start|Back to main Xfce documentation page]] |