Difference between revisions of "How to Contribute"

From PINE64
Jump to navigation Jump to search
(Created page with "Did you know that according to the popular [https://en.wikipedia.org/wiki/1%25_rule_(Internet_culture) 1% rule], only 1% of the users of an internet community add content, whi...")
 
(added some examples)
Line 3: Line 3:
== Reporting issues ==
== Reporting issues ==


{{hint|Why shouldn't I report issues in the community chats?
Reporting issues is a great way to contribute (if done correctly). The software projects are using bug trackers to keep track of bugs and to link patches or changes with these bug reports.


Reporting issues in the community chats is actually a bad idea for multiple reasons:
See the article [[User:Fxc/Where_to_Report_Bugs|where to report bugs]] to find out where you can report bugs.


* Development takes place in platforms such as GitLab, sourcehut and Github with a certain procedure (issue reports, commits, linking to the issues and marking them solved). Chat reports are not a part of that procedure.
== Contributing code ==
* Talking about an issue and workarounds carries the discussion further away from the actual development and leads to discussions in forums and chatrooms, in contrast to bug trackers.
 
* Shared and accepted workarounds don't find their way back into the code and may be accepted as "tolerable evil".
By contributing code, for example to the following projects (alphabetical order):
* Bug reports in chats are getting scrolled out, repeated and as a result get annoying for everyone involved and leads to future users with the same or similar issues not getting helped anymore.  
 
* It is expected that people mentioning issues also report them. Chatting about them without reporting them makes everyone think it is reported already and then the issue will never be reported (and therefore not fixed).
* KDE: see [https://community.kde.org/Get_Involved Get Involved] and [https://community.kde.org/Help:Contribute Help:Contribute]
* The transition from community to developer are fluent, we don't have situations of "they above" versus the "we the users, who have to help themselves" here, like other commercial projects have. Don't even think about trying to bring such mindsets into the community.
* Plasma Mobile: https://plasma-mobile.org/get-source/ (see the "Contributing" section)
 
== Donating to community projects and developers ==


}}
Many community projects and developers are working on the software on their free time. Donating to community projects and developers is a great way to support these projects and developers developing the software for the devices. The following list is an exemplary selection to which projects and developers can be donated to (in alphabetical order):


== Contributing code ==
=== Projects ===
* Manjaro ARM: [https://en.liberapay.com/Manjaro-ARM/ Liberapay], [https://www.patreon.com/manjaroarm Patreon]
* postmarketOS: https://postmarketos.org/donate/
 
=== Developers ===
* Danct12: [https://ko-fi.com/danct12 Ko-fi], [https://liberapay.com/Danct12 Liberapay], [https://patreon.com/Danct12 Patreon]
* megi: https://xnux.eu/contribute.html#toc-donations


== Help with the documentation ==
== Help with the documentation ==


== By being a positive member of the community ==
== By being a positive member of the community ==

Revision as of 12:53, 21 March 2022

Did you know that according to the popular 1% rule, only 1% of the users of an internet community add content, while the other 99% of the users only consume content? However there is plenty ways to contribute and to help your favorite project to flourish, even without writing code. As follows are some examples on ways to contribute.

Reporting issues

Reporting issues is a great way to contribute (if done correctly). The software projects are using bug trackers to keep track of bugs and to link patches or changes with these bug reports.

See the article where to report bugs to find out where you can report bugs.

Contributing code

By contributing code, for example to the following projects (alphabetical order):

Donating to community projects and developers

Many community projects and developers are working on the software on their free time. Donating to community projects and developers is a great way to support these projects and developers developing the software for the devices. The following list is an exemplary selection to which projects and developers can be donated to (in alphabetical order):

Projects

Developers

Help with the documentation

By being a positive member of the community