Xfce Wiki

Sub domains
 

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
contribute:start [2014/03/05 13:35] – created nickcontribute:start [2025/02/09 15:44] (current) – [Financial Contributions] Remove note about pausing, it was never possible to actually pause donations andreldm
Line 1: Line 1:
-====== 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 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. 
 + 
 +For a list of our supporters and details on individual transactions, see our [[supporters|Supporters page]]. 
 + 
 +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]]