Documentation/contributor/administration.itexi

   1 @c -*- coding: utf-8; mode: texinfo; -*-
   2 @node Administrative policies
   3 @chapter Administrative policies
   4
   5 This chapter discusses miscellaneous administrative issues which
   6 don't fit anywhere else.
   7
   8 @menu
   9 * Meta-policy for this document::
  10 * Meisters::
  11 * Unsorted policies::
  12 @end menu
  13
  14 @node Meta-policy for this document
  15 @section Meta-policy for this document
  16
  17 The Contributor's Guide as a whole is still a work in progress,
  18 but some chapters are much more complete than others.  Chapters
  19 which are @qq{almost finished} should not have major changes
  20 without a discussion on @code{-devel}; in other chapters, a
  21 disorganized @qq{wiki-style dump} of information is encouraged.
  22
  23 Do not change (other than spelling mistakes) without discussion:
  24
  25 @itemize
  26
  27 @item
  28 @ref{Introduction to contributing}
  29
  30 @item
  31 @ref{Working with source code}
  32
  33 @end itemize
  34
  35 Please dump info in an appropriate @@section within these manuals,
  36 but discuss any large-scale reorganization:
  37
  38 @itemize
  39
  40 @item
  41 @ref{Compiling}
  42
  43 @item
  44 @ref{Documentation work}
  45
  46 @item
  47 @ref{Issues}
  48
  49 @item
  50 @ref{Regression tests}
  51
  52 @item
  53 @ref{Programming work}
  54
  55
  56 @end itemize
  57
  58 Totally disorganized; do whatever the mao you want:
  59
  60 @itemize
  61
  62 @item
  63 @ref{Website work}
  64
  65 @item
  66 @ref{LSR work}
  67
  68 @item
  69 @ref{Release work}
  70
  71 @item
  72 @ref{Administrative policies}
  73
  74 @end itemize
  75
  76
  77
  78 @node Meisters
  79 @section Meisters
  80
  81 We have four jobs for organizing a team of contributors:
  82
  83 @itemize
  84
  85 @item
  86 Bug Meister: trains new Bug Squad volunteers, organizes who works
  87 on which part of their job, checks to make sure that everything is
  88 running smoothly, and has final say on our policy for Issues.
  89
  90 Currently: Phil
  91
  92 @item
  93 Doc Meister: trains new doc editors/writers, organizes who works
  94 on which part of the job, checks to make sure that everything is
  95 running smoothly, and has final say on our policy for
  96 Documentation.  Also includes LSR work.
  97
  98 Currently: Graham
  99
 100 @item
 101 Translation Meister: trains new translators, updates the
 102 translation priority list, and handles merging branches (in both
 103 directions).
 104
 105 Currently: Francisco
 106
 107 @item
 108 Frog Meister: is responsible for code patches from (relatively)
 109 inexperienced contributors.  Keeps track of patches, does initial
 110 reviewing of those patches, sends them to @code{-devel} when
 111 they've had some initial review on the Frog list, pesters the
 112 @code{-devel} community into actually reviewing said patches, and
 113 finally pushes the patches once they're accepted.  This person is
 114 @emph{not} responsible for training new programmers, because that
 115 would be far too much work -- he job is @qq{only} to guide
 116 completed patches through our process.
 117
 118 Currently: Carl
 119
 120 @end itemize
 121
 122
 123
 124 @node Unsorted policies
 125 @section Unsorted policies
 126
 127 @subsubheading Language-specific mailing lists
 128
 129 A translator can ask for an official lilypond-xy mailing list once
 130 they've finished all @qq{priority 1} translation items.
 131
 132 @subsubheading Performing yearly copyright update (@qq{grand-replace})
 133
 134 At the start of each year, copyright notices for all source files
 135 should be refreshed by running the following command from the top of
 136 the source tree:
 137
 138 @example
 139 make grand-replace
 140 @end example
 141
 142 Internally, this invokes the script @file{scripts/@/build/@/grand@/-replace@/.py},
 143 which performs a regular expression substitution for old-year -> new-year
 144 wherever it finds a valid copyright notice.
 145
 146 Note that snapshots of third party files such as @file{texinfo@/.tex} should
 147 not be included in the automatic update; @file{grand@/-replace@/.py} ignores these
 148 files if they are listed in the variable @code{copied_files}.
 149
 150
 151 @subsubheading Push git access
 152
 153 Git access is given out when a contributor has a significant
 154 record of patches being accepted without problems.  If existing
 155 developers are tired of pushing patches for a contributor, we'll
 156 discuss giving them push access.  Unsolicited requests from
 157 contributors for access will almost always be turned down.
 158
 159