How to help

From ParabolaWiki
Jump to: navigation, search
Summary
This article describes how both new and experienced Parabola users can contribute to the community
Related
FAQ
Help:Editing

Parabola is a GNU/Linux-libre distribution made by volunteers. Therefore all users are encouraged to get involved and further improve Parabola.

This article describes how both new and experienced Parabola users can contribute to the community. Note that this is not an exhaustive list. Before contributing, please get accustomed with the Parabola Social Contract.

1 Community

1.1 Post on the forums

One of the easiest ways to get involved is participating in the Parabola Forums, which allow getting to know the community and help new users.

1.2 Improve this wiki

Parabola Wiki is a collaboratively maintained Parabola documentation. All users are encouraged to contribute. You can write and maintain articles and/or translate articles.

Resources
Wiki Editing
Wiki Conversion
Wiki internationalization
You will learn
documenting software, wikimedia language

1.3 Write an experience report

Help Parabola getting more popular by writing an experience report. By reading experience reports, potentially new users can see how great a life in freedom is.

1.4 Join the chatroom

You can help other users solve problems on the IRC channels.

1.5 Join the mailing lists

Join the discussion on one or more of the public mailing lists. Make sure to stay on topic as provided in the list description.

2 Packaging

2.1 Fix and report bugs

Reporting and fixing bugs on the bug tracker is one of the possible ways to help the community.

However, ineffective use can be counter-productive. If bugs should be reported upstream. Posting upstream bugreports makes fixing them in Parabola much easier.

Resources
Bug reporting guidelines

2.2 Code review and test packages

Changes in packages and blacklist are added when a single developer considers them working on their machine. It is not sufficient, especially when upgrades depend on specific hardware, other packages or deciding package's compatibility with our freedom guidelines requires experience with that package.

Find a reasonable way of getting every change reviewed by other developers or users before they are applied. This probably implies not having packages built on developer's computers.

Packages on the testing repositories need to be tried out and signed off before they are promoted to the main repositories. Help the Parabola hackers test new packages.

Resources
projects
Repositories

2.3 Inform about security issues

New vulnerabilites are found all the time. Help the Parabola hackers keep track of new vulnerabilities.

2.4 Create -libre packages

Sometimes, nonfree packages can be liberated. Help to adapting Pkgbuilds and/or applying patches to the software.

Resources
Guidelines for Free System Distributions
Some problems which don't make the package nonfree
Creating -libre packages
You will learn
free software licensing, package building, practical problems of some nonfree restrictions

2.5 Find and remove nonfree packages

Parabola adheres to the : Guidelines for Free System Distributions and therefore provides only free packages. However, Parabola builds upon Arch Linux and redistributes Arch Linux' free packages directly. Help to find nonfree packages and remove them.

The most common problems are documentation/UI of a program recommending nonfree software or software under nonfree licenses (typically restricting commercial use or modifications). Usually no programming knowledge is needed.

Resources
Guidelines for Free System Distributions
Some problems which don't make the package nonfree
How to Blacklist a package
You will learn
free software licensing, practical problems of some nonfree restrictions

2.6 Fix package build problems

Some packages are rarely updated and cannot be compiled now without changes. Fixing them would make porting to other architectures and changing the packages to make them more useful easier.

If a change is not needed to compile the package in Parabola-specific ports and is in package not modified by Parabola, it should be reported directly to Arch.

Resources
Arch Issue Tracker
You will learn
Arch packaging and libretools

2.7 Delay updates when they need changing our packages

Currently we automatically get new packages from Arch every day. If they depend on newer versions of packages that we modify (like dependency libraries), then updates fail or break users' systems. Make the repo update scripts detect this issue and delay updates from Arch (of affected packages only, or all packages?) when this occurs.

Resources
dbscripts

3 Software projects

The Parabola distribution comprises of many components, such as the libre build system (abslibre), the parabola.nu website (parabolaweb), or the graphical installer for Parabola (calamares) Each of these projects can be contributed to individually.

The projects themselves are hosted with git on git.parabola.nu.

You can find out how to help sustaining server costs on the official Parabola donate page.

5 Acknowledgement

This wiki article is based on ArchWiki. We may have removed non-FSDG bits from it.