== Committing ==

=== Non-Native Packages ===

Non-native packages have a `master` branch containing the "upstream" component, and a `debian` branch which contains the upstream component and the debian packaging.

'''If you are changing the "upstream" code:'''
* Check out the `master` branch, and apply your changes.
* Ensure you updated the version of the software.  This is either in `configure.ac`, `setup.py`, or a `VERSION` file.
* Review your commits, and rebase if necessary.
* Tag the commit with the version number, and an annotated tag saying something like "Releasing 1.2.3"
 * `git tag -a 1.2.3 a4b5c6d7`
* Push your master branch, and the tag to `origin`.  
 * '''Once you do this, the version is finalized.  If you find a bug, you'll need to bump the version number and repeat this process.
* Check out the debian branch, and merge master into it.  You are now ready to update the packaging.

'''Updating the packaging'''  
* Make your packaging changes (if any)
* Add a changelog entry for the new version, remebering to reset the Debathena component to `-0debathena1` if there's a new "upstream" version.
* Push debian to `origin`.

=== Native Packages ===

Native packages only have a `master` branch.

* Make any changes, and update the changelog.
* Push master to `origin`.

Native packages are '''not''' tagged, as the tagging happens at build time.

== Building ==

Note: <package> below means the directory in the repo 

'''Non-native packages have an additional step, prior to building'''
* `athena-upstream-tarball -p <package>`

'''Building packages'''
* `dasource -u <directory-name>`
 * builds source package
* `dapublish [all | package ...]`
 * publish source package to repo, sign and tag
* `dabuild all`
 * builds any package for which there are source but no binary

== Adding a new package ==

Victor should fill in this part, explaining what is necessary when adding a new package (e.g. debathena-shiny-new-thing).  Steps include: adding it to the superrepo, making the build tools aware of it (so that uptsream-tarball and dasource don't fail), etc.

== Bootstrapping A New Release ==

Victor should fill in this part for bringing `utopic` (14.10) online.