git.sur5r.net Git - glabels/blob - HACKING

   1 ===============================================================================
   2
   3 Developers:
   4 ===========
   5
   6 Do NOT commit to this module without permission from a maintainer;
   7 see the MAINTAINERS file for who they are.  You should also discuss any
   8 changes at:
   9
  10 https://github.com/jimevins/glabels/issues
  11
  12 See below for additional guidelines.
  13
  14
  15 Translators:
  16 ============
  17
  18 Translation commits are always welcome. Please recognize any rules from
  19 your local team of the GNOME Translation Project. You may add or change
  20 the following files:
  21
  22 /po/*.po
  23 /po/LINGUAS
  24 /help/*/*.po
  25 /help/Makefile.am
  26
  27 Please don't edit the file POTFILES.in without approval from a
  28 maintainer.
  29
  30
  31 ===============================================================================
  32
  33
  34 ROADMAP
  35 =======
  36
  37 See the TODO file in this directory.
  38
  39
  40 BRANCHES
  41 ========
  42
  43 gLabels will typically have 2 active branches: a stable branch and a
  44 development branch.  A branch represents a series of releases with a
  45 fixed major and minor version.  The minor version will be an even
  46 number for a stable branch and will be an odd number for a development
  47 branch.  For example the "2.2.5" release would be from a stable branch
  48 and "2.3.5" would be a development release.
  49
  50 Stable branch
  51 -------------
  52
  53 Some characteristics of a stable branch:
  54
  55 - Prerequisites are fixed for the lifetime of the branch.
  56 - The primary purpose of releases within a branch is to fix bugs.
  57 - Besides bug fixes, releases may also include new and updated translations,
  58   updated documentation, and new label templates.
  59 - Generally, no new features will be introduced by a release within a
  60   stable branch unless it is necessary to fix a bug.  Such a fix should not
  61   introduce new prerequisites.
  62 - Nor will code be refactored unless it is necessary to fix a bug.
  63 - The Git branch will be named glabels_major_minor.  E.g. "glabels_2_2".
  64
  65 Unstable/development branch
  66 ---------------------------
  67
  68 Some characteristics of a development branch:
  69
  70 - Prerequisites are volatile and may change release to release.
  71 - The primary purpose of releases is to introduce new features and
  72   get them in the hands of testers.
  73 - Features and file formats may be volatile and change release to
  74   release.
  75 - No attempt will be made to maintain backwards compatibility with
  76   development releases.
  77 - The development branch is maintained in the Git master branch.