====== Contributing to SliTaz ======
SliTaz is made by volunteers and everyone is welcome. Introduce yourself on the [[https://maille.slitaz.org/|forum]] (Maille) and say what you would like to do. The handbook has a short [[https://doc.slitaz.org/handbook/help.html#contribute|Contributing]] section.
===== Testing =====
* Test development images published on [[https://lab.slitaz.org/|lab.slitaz.org]].
* Use **TazHelper** (on the dock, ''tazhelper'' in text mode): it runs automatic checks, guides you through a checklist and sends an anonymous test report. Manual: [[https://doc.slitaz.org/manuals/tazhelper/tazhelper.en.html|TazHelper]].
* Try packages from [[https://pkgs.slitaz.org/|pkgs.slitaz.org]] with ''spk-add'' and report what is broken.
===== Reporting bugs =====
Open //Report a bug// (Filature report) from the dock or the Dash, describe the problem and send. In text mode:
$ filature-report
Accepted reports become public bugs on [[https://filature.slitaz.org/bugs|filature.slitaz.org/bugs]]. See [[https://doc.slitaz.org/handbook/help.html#bugs|Handbook: Reporting a bug]]. For a question rather than a bug, use the forum and attach the output of ''trame system report''.
===== Packaging =====
Packages are built from //receipts//, small shell files: example using cookutils:
# spk-add cookutils
# cook setup --wok
# cook new mypkg
# nano /home/slitaz/wok/mypkg/receipt
# cook mypkg
* [[https://doc.slitaz.org/handbook/build.html|Handbook: Build your own]]
* [[https://doc.slitaz.org/manuals/cookutils/cookutils.en.html|Cookutils manual]] and [[https://doc.slitaz.org/manuals/cookutils/receipts-v2.html|receipt format v2]]
* Official receipts: the wok on [[https://hg.slitaz.org/|hg.slitaz.org]]. Packages are built on [[https://cook.slitaz.org/|cook.slitaz.org]].
When a receipt builds and the package installs, send it to a developer or post it on the forum for review.
===== Code =====
The source of every tool, including the handbook is in the Mercurial repositories on [[https://hg.slitaz.org/|hg.slitaz.org]]. Read the code, fix it and send a patch or ask on the forum who maintains it.
===== Translations and documentation =====
* [[https://doc.slitaz.org/handbook/|doc.slitaz.org]] is the official documentation, written by the developers. To improve the handbook, send a patch against the ''slitaz-doc'' repository or report what is wrong.
* This wiki holds community guides. Pick a page, check which release it was written for and update it for 5.1.
* Translations of the tools and of the handbook are welcome: ask on the forum which language and files need help.