Xfce Wiki

Sub domains
 

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
contribute:start [2021/05/11 21:21] – added link to EU page and updated text kevinbowencontribute:start [2026/08/21 00:57] (current) – Remove outdated OpenSuse VM information kevinbowen
Line 6: Line 6:
 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. 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.
  
-If you would like to donate to Xfce, please see the [[start#Donations|Donations]] section.+If you would like to donate to Xfce, please see the [[start#Financial Contributions|Donations]] section.
  
   * **[[#Bug Reporting and Testing|Bug Reporting and Testing]]**   * **[[#Bug Reporting and Testing|Bug Reporting and Testing]]**
Line 12: Line 12:
   * **[[#Development|Development]]**   * **[[#Development|Development]]**
   * **[[#Documentation|Documentation]]**   * **[[#Documentation|Documentation]]**
-  * **[[#Donations|Donations]]**+  * **[[#Financial Contributions|Financial Contributions]]**
   * **[[#Feature Requests|Feature Requests]]**   * **[[#Feature Requests|Feature Requests]]**
   * **[[#Translation|Translation]]**   * **[[#Translation|Translation]]**
Line 20: Line 20:
 ===== Bug Reporting and Testing ===== ===== 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 the [[https://gitlab.xfce.org/|Xfce GitLab 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, see [[.:bugs/start|Bug Reporting and Fixing]].+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]]
  
-  * For a list of currently open bugs, see the [[:contribute:bugs:bug-summary|open bugs summary]].+  * You can ask for help on [[https://docs.xfce.org/contribute/dev/start#communication_with_the_xfce_development_team|various channels]].
  
-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.+  * Please do not use the forums to report bugs. 
  
-  * 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.   +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]].  
-  * [[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.+ 
 +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.22, 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.
  
 ---- ----
Line 48: Line 55:
 ===== 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. +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/|API reference]] is automatically updated on a weekly basis based on the latest stable releases.+The [[https://developer.xfce.org/|Xfce API reference]] is automatically updated on a weekly basis based on the latest stable releases.
  
 ---- ----
    
-===== Donations =====+===== 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.  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 via [[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.+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}}]] [[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]] 
  
 ---- ----
Line 66: Line 88:
 Although the philosophy of Xfce is to find the correct balance between features and lightweight, it is still possible to request new features. Although the philosophy of Xfce is to find the correct balance between features and lightweight, it is still possible to request new features.
  
-The right approach for larger changes is to discuss them on the mailing list, or on our IRC channel [[irc://irc.freenode.net/#xfce-dev|#xfce-dev on Freenode]] first. You might think your idea is brilliant, but there is a high possibility that there are major downsides.+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.
  
-Afterwards a bug can be opened in the bug tracker. Make sure the //Importance// is set to //normal// and //enhancement//.+Obviously, the best way to get your new feature integrated is, to provide a merge request that implements it !
  
-Obviously, it would be nice if you could write a patch that implements the new feature.+Please note that some components are rather unmaintained, so you might not always get a reply.
  
 ---- ----