Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision |
contribute:start [2021/01/19 09:38] – [Communication] alexxcons | contribute:start [2023/02/06 08:16] – fix Donations link kevinbowen |
---|
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]]** |
* **[[#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]]** |
===== 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]] |
| |
| * You can ask on our IRC channel [[irc://irc.libera.chat/#xfce|#xfce on Libera.chat]] for help. A [[https://web.libera.chat/#xfce|web irc interface]] is also available if you don't have an irc client. |
| |
| * 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]]. |
| |
| |
There are various ways to get in touch with Xfce developers: | There are various ways to get in touch with Xfce developers: |
| |
* For general questions, [[https://forum.xfce.org/|Xfce's Forum]], the [[https://mail.xfce.org/mailman/listinfo/xfce|Xfce mailing list]], and our IRC channel [[irc://irc.freenode.net/#xfce|#xfce on Freenode]] are the places to go. | 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. |
* [[https://matrix.org/|Matrix]] provides a bridge to the #freenode <nowiki>IRC</nowiki> network. So you as well can connect to [[https://matrix.to/#/#freenode_#xfce:matrix.org|our IRC channel]] with any matrix client and even use matrix as an bouncer. | |
* For any translation stuff, join the [[https://mail.xfce.org/mailman/listinfo/xfce-i18n|Xfce-i18n mailing list]]. | |
* For anything code related, go to the [[https://mail.xfce.org/mailman/listinfo/xfce4-dev|Xfce-dev mailing list]], or our IRC channel [[irc://irc.freenode.net/#xfce-dev|#xfce-dev on Freenode]]. | |
| |
All Xfce developers have a real life and live across multiple time zones. If you don't get an answer straight away, be patient and stay online! | |
| |
---- | ---- |
| |
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://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://developer.xfce.org/|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. |
| 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): |
| |
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. | [[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. |
| |
{{https://www.bountysource.com/badge/team?team_id=849&style=raised&.jpg?}} | For a list of our supporters and details on individual transactions, see our [[supporters|Supporters page]]. |
| |
---- | ---- |
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. |
| |
---- | ---- |