This document contains polcies and workflow for ArcheOS development. Is intended as a “bird view” of the daily and extra-ordinary work the ArcheOS developers follows.
ArcheOS releases follows roughly the Debian cycle, with a new release of ArcheOS when a new Debian is released. Sometimes can happens that ArcheOS is released long after Debian, depending on the time the developers (after all is a non-profit work) have to spend on packaging and testing and building.
This section describes the regular, day-to-day work the developers do when a new version of ArcheOS is released and consolidated. This means working primary on existing, already packaged software, bug fixing, collecting requests for next version and so on.
This list should be exhaustive about what to do when a users reports a bug to ArcheOS.
Bugs in ArcheOS specific applications (eg. ``ppt``).
Bugs for internally developed software must be submitted to the corresponding GitHub repository. When triaged and fixed a new package version is created for the affected software adding a patch revision number. It is then included into the current stable distribution on reprepro so ArcheOS user can upgrade in the correct way.
Bugs for third-part software packaged by ArcheOS developers.
These bugs must be reported to upstream developers. If a new version is available to fix this bug ArcheOS developers will fetch and package it. Will be then included in the stable distribution or reprepro so ArcheOS users can upgrade it. If the upstream maintainer cannot fix the bug ArcheOS developers can try to, being sure to send the patch to the upstream developers after the bug fix is confirmed.
Bugs for Debian software.
As stated in the Debian Derivatives Guidelines bugs must be submitted (after triaging) to the Debian bug-tracking system. When a patch will be available Debian will create a new package and release it using the usual channels. No intervention from ArcheOS developers should be needed in this case.
Bugs related to the ArcheOS system.
This can include bugs affecting some way the behavior of the live system (eg. “Can’t boot”). The bug should be reported to the main ArcheOS repository bug tracking system.
Bugs related to the ArcheOS menu.
These bugs must be submitted to the archeos-menu package bug tracking system. ArcheOS developers will then fix the issue and prepare a new archeos-menu version to be uploaded in the current stable repository for upgrading the usual way.
As a general rule, requests for features (new software packaging, software modifications, and so on) submitted to ArcheOS will go to the next release. Exceptionally some very important features can be integrated into the current release. In this case consider them as a “bug” rather than a “feature” (see section Bug tracking).
Request for new software packaging.
These requests must be submitted to the archeos-meta bug tracking system. The milestone must be set to archeos-next and the appropriate label. ArcheOS developers should then check that:
The software will then be included in the next ArcheOS release.
Request for new software inclusion.
This is for software that is already present into the Debian repositories at the version needed and with all required features. Also in this case an issue must be opened to the archeos-meta bug tracking system with milestone archeos-next and appropriate labels. The software will then be included in the next ArcheOS release.
Request for new feature in existing software.
If this kind of feature can be enabled in an already included software (eg. using a compilation option), this should be reported in the ArcheOS software repository or in archeos-meta bug tracking system, depending if the software is produced/packaged by ArcheOS developers or if just included as deendency in archeos-meta. Same checks for new software packaging should be performed. The software will then be included in the next ArcheOS release.
Some high-level guidelines and reminders about working on ArcheOS repositories:
This section contains all steps, although at high-level, needed when a new ArcheOS version has to be released.