Difference between revisions of "Contributing"

From postmarketOS
Jump to navigation Jump to search
(remove contribution requests for blog posts, as we'll mostly write about new service packs and releases from now on, and that's doable)
m (remove blogging too)
 
Line 7: Line 7:
 
To work on something specific, see the issues tagged with '''[https://gitlab.com/groups/postmarketOS/-/issues?label_name%5B%5D=help+wanted help wanted]''' ([https://gitlab.com/groups/postmarketOS/-/issues?scope=all&utf8=%E2%9C%93&state=opened&label_name%5B%5D=help%20wanted&label_name%5B%5D=difficulty%3A%3Aeasy easy ones]).
 
To work on something specific, see the issues tagged with '''[https://gitlab.com/groups/postmarketOS/-/issues?label_name%5B%5D=help+wanted help wanted]''' ([https://gitlab.com/groups/postmarketOS/-/issues?scope=all&utf8=%E2%9C%93&state=opened&label_name%5B%5D=help%20wanted&label_name%5B%5D=difficulty%3A%3Aeasy easy ones]).
  
== Documentation and Blogging ==
+
== Documentation ==
 
=== Wiki documentation ===
 
=== Wiki documentation ===
 
* Create new pages if you found a new postmarketOS topic worth documenting. If you did not find what you want to create, click "create new page" in the search results.
 
* Create new pages if you found a new postmarketOS topic worth documenting. If you did not find what you want to create, click "create new page" in the search results.

Latest revision as of 19:26, 18 April 2021

We have a separate donate page. This article is about contributing in everything but donations.

Hello there, glad you are reading this page. We have a broad spectrum of topics to contribute, and some of them do not even require programming or scripting knowledge. With each contribution, you don't just get to help out your fellow postmarketOS friends, but there's always a chance to learn something new and sharpening your skills along the way. And of course fun, fame and epic stories to tell to your grandchildren about what a badass hacker you have been. Now pick what interests you most.

GitLab issues

First of all, consider subscribing to the GitLab issues. The most important discussions happen there, on all levels. From broad visions to implementation details and bug reports. Voice your opinions and help out others with your knowledge, so there are more people that can in turn help out yourself when you get stuck. If you are a developer, consider testing and reviewing incoming patches (merge requests). The more eyeballs on the code, the less bugs get introduced.

To work on something specific, see the issues tagged with help wanted (easy ones).

Documentation

Wiki documentation

  • Create new pages if you found a new postmarketOS topic worth documenting. If you did not find what you want to create, click "create new page" in the search results.
  • Structure:
    • Improve the structure of the wiki, make sure there's a clear path from the main page to every specific page that the user would be interested in
    • Fix the orphaned pages and links to non-existing pages (do not add more of those!)
    • Add and use wiki categories where it makes sense
  • Formatting:
  • Other fixes for existing pages:
    • Check if the sentences make sense
    • Fix typos and grammar
    • Add links to relevant GitLab issues and other pages

Hacking

Translating

Help translate postmarketOS.

Help out others

Get active in the community and help everyone along the way, with motivation or practical tips on whatever they are doing.

Tell your friends!

Help upstream projects

You probably know the whole "we are standing on shoulders of giants" speech. Depending on the components you are looking at in postmarketOS, the giants are not that big and bloated, but of course they would happily accept help by contributors interested in their projects.

Administrative

This list is for admins only, most people don't need to bother with this stuff.

See also