wiki/src/contribute/relationship_with_upstream.mdwn

   1 [[!meta title="Relationship with upstream"]]
   2
   3 [[!toc levels=2]]
   4
   5 # Why this document?
   6
   7 The Debian Derivatives Guidelines ([[!debwiki Derivatives/Guidelines]])
   8 encourages "derivative distributions to
   9 mention and define their relationship with Debian". Because this seems
  10 like a great idea to us, we wrote this statement that not only covers
  11 Tails' relationship with Debian, but also Tails' relationship with any
  12 one of its upstream projects.
  13
  14 # Summary
  15
  16 For various reasons Tails tries to diverge by the smallest possible
  17 amount from its upstream projects, and especially from Debian:
  18
  19 - We want to share our work with the rest of the Free Software
  20   community.
  21 - We value maintainability very much: we believe our users are best
  22   served if we keep the amount of work needed to maintain Tails the
  23   smallest possible.
  24
  25 # How
  26
  27 ## Upstream software
  28
  29 We try to push our changes upstream when we need to modify software we
  30 ship. This often requires us to write code in a generic way, rather
  31 than implementing ad-hoc hacks to fit our specific needs: e.g. we
  32 often need to make the stuff we need opt-in and add configuration
  33 options.
  34
  35 ## Debian packaging
  36
  37 Debian offers great amounts of flexibility to derivative developers,
  38 so we seldom need to modify Debian-specific parts of the software we
  39 ship. In the rare cases we need to:
  40
  41 - we at least inform the relevant Debian maintainers, so that they
  42   have a chance to enhance their packages to fit our needs;
  43 - in many cases, we write and propose patches that would allow us to
  44   install unmodified Debian packages in Tails.
  45
  46 We also encourage potential contributors to [[improve Tails by working
  47 on Debian|contribute/how/debian]].
  48
  49 <a id="debian-bts"></a>
  50
  51 ### Debian Bug tracking system
  52
  53 We file and contribute to RFP and WNPP bugs so that software we need
  54 lands in Debian. More generally, we heavily use the Debian
  55 infrastructure such as the [BTS](https://bugs.debian.org/).
  56
  57 We use usertags ([documentation](https://wiki.debian.org/bugs.debian.org/usertags),
  58 [reporting](https://www.debian.org/Bugs/Reporting)) to track bugs we
  59 are interested in on the Debian BTS.
  60
  61 See the full and up-to-date list of bugs:
  62
  63 * [sorted by usertag](https://udd.debian.org/cgi-bin/bts-usertags.cgi?user=tails-dev@boum.org);
  64 * [sorted by severity](https://bugs.debian.org/cgi-bin/pkgreport.cgi?users=tails-dev@boum.org).
  65
  66 **Warning**: do **not** use tags that are already [defined
  67 globally](https://www.debian.org/Bugs/Developer#tags) on the BTS.
  68
  69 ## Build tools
  70
  71 We contribute to [Debian Live](http://live.debian.net/) on a regular
  72 basis. Every single feature we have added to Debian Live has been
  73 merged upstream, and we intend to go on this way.