====== 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.