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はボランティアによって作られたGNU/Linux-libreディストリビューションです。したがって、全てのユーザーがコミュニティに参加しParabolaを改善していくことを奨励しています。

この記事では、Parabolaの新規ユーザーと経験豊富なユーザーの双方が、コミュニティに参加してこのプロジェクトに貢献する方法について説明します。ここに書かれていることが貢献する方法を網羅しているわけではないことに注意してください。また、貢献する前にParabola GNU/Linux-libre社会契約を確認してください。

1 コミュニティ

1.1 フォーラムか「assist」メーリングリストに投稿する

コミュニティに参加する最も簡単な方法は、Parabolaコミュニティフォーラムassistメーリングリストに投稿し参加することです。これによりコミュニティを理解し、新しいユーザーを手助けすることができます。

1.2 Wikiを改善する

Parabola Wikiはコミュニティのメンバーによって共同で管理されているParabolaのドキュメントです。全てのユーザーが貢献することを奨励しています。新しい記事の作成と保守、翻訳を行うことができます。

資料
Wikiの編集
Wikiの移行
Wikiの国際化
習得する内容
文書作成ソフト, wikimedia言語

1.3 体験レポートを書く

体験レポートを書いてParabolaをより人気のあるものにしましょう。体験レポートによって潜在的な新規ユーザーが自由の中での活動がどれほど素晴らしいかを知ることができます。

1.4 チャットルームに参加する

IRCチャンネルに参加することで、他のユーザーの抱える問題の解決を手伝うことができます。

1.5 開発メーリングリストに参加

「dev」メーリングリストの議論に参加してください。

2 パッケージング

2.1 不具合の報告と修正

課題追跡システムで不具合の報告と修正を行うことは、コミュニティを手助けできる方法のひとつです。ただし、適切に使用しない場合は逆効果になる可能性があります。upstreamで報告する必要性がある場合、upstreamに不具合の報告を行うとParabolaでの修正が容易になります。

資料
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
How to contribute to Parabola's Repositories


2.3 Inform about security issues

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


2.4 Create -libre packages

Sometimes, non-free 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 non-free
How to contribute to Parabola's Repositories
Creating -libre packages
You will learn
free software licensing, package building, practical problems of some non-free restrictions


2.5 Identify non-free 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 non-free packages and remove them.

The most common problems are documentation/UI of a program recommending non-free software or software under non-free 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 non-free
How to Blacklist a package
You will learn
free software licensing, practical problems of some non-free 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
How to contribute to Parabola's Repositories
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 Parabola Custom 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.

4 Graphics Design and other Artworks

Supporting artistic freedom (aka. Free Culture) is one of the core goals expressed in the Parabola Social Contract. If you have a talent for art, music, graphics, sound, or web design, please consider helping the Parabola desktops and websites to be more aesthetically pleasing and artistically inspiring.


5 Share Parabola Packages and ISOs

If you have a server with sufficient up-time, disk space, and bandwidth, you could operate a package mirror service. That would help to increase the robustness of the standard mirror network.

You can also help to increase the robustness of Parabola repos using any personal computer. It is not necessary to have a powerful server for this. Pacman2Pacman is a peer-to-peer package sharing network using the bittorrent protocol. This allows sharing of packages between users without any central servers, and keeps Parabola healthy even if the master repo server and all standard mirrors were offline.

The Parabola project operates entirely on friendly donations. Any such donation should not be considered as a charitable donation, but a personal gift to one or all of the current Parabola developers, or indirectly to all Parabola users.

You can find out how to support Parabola development and maintenance financially on the official Parabola donate page.

You could also support Parabola development by donating hardware, especially those that advance the state of software/hardware freedom, such as RISC-V and POWER9, and single-board computers that are quirky and difficult to support generally. A POWER9 Talos computer, for example, would surely earn you the distinction of: Friend of Freedom Extraordinaire. Of course, do ask if that particular hardware is something that likely or desired to be supported. There are many computers that are simply not practical or popular enough to justify the human resources required to support them.

Note: Parabola currently needs a new permanent web server or VPS, in order to remove that load and security concern from the core repo server. We would prefer that the donor could be associated with some libre-friendly organization, so that we could proudly present their logo on the Parabola home page; but that is not a strict requirement. The minimum requirements are roughly as such:
Memory: 2   GB
Disk:   250 GB