Documentation/included/helpus.itexi

   1 @c -*- coding: utf-8; mode: texinfo; -*-
   2 @c This file is part of web/community.itexi and
   3 @c contributor/introduction.itely
   4
   5 @macro helpusNeed
   6 @subheading We need you!
   7
   8 The LilyPond development team is quite small; we really want to
   9 get more people involved.  Please consider helping your fellow
  10 LilyPond users by contributing!
  11
  12 Even working on small tasks can have a big impact: taking care of
  13 them allows experienced developers work on advanced tasks, instead
  14 of spending time on those simple tasks.
  15
  16 @end macro
  17
  18
  19 @macro helpusTasks
  20 @subheading Simple tasks
  21
  22 No source code or compiling required!
  23
  24 @itemize
  25 @item
  26 Mailing list support: answer questions from fellow users.
  27
  28 @item
  29 Bug reporting: help users create proper @rweb{Bug reports}, and/or
  30 join the Bug Squad to organize @rcontrib{Issues}.
  31
  32 @item
  33 Documentation: small changes can be proposed by following the
  34 guidelines for @rcontrib{Documentation suggestions}.
  35
  36 @item
  37 LilyPond Snippet Repository (LSR): create and fix snippets
  38 following the guidelines in
  39 @rcontrib{Adding and editing snippets}.
  40
  41 @item
  42 Discussions, reviews, and testing: the developers often ask for
  43 feedback about new documentation, potential syntax changes, and
  44 testing new features.  Please contribute to these discussions!
  45
  46 @end itemize
  47
  48 @subheading Advanced tasks
  49
  50 These jobs generally require that you have the source code and can
  51 compile LilyPond.
  52
  53 @warning{We suggest that contributors using Windows or MacOS X do
  54 @strong{not} attempt to set up their own development environment;
  55 instead, use lilybuntu as discussed in @rcontrib{Quick start}.}
  56
  57 Contributors using Linux or FreeBSD may also use Lilybuntu, but if
  58 they prefer their own development environment, they should read
  59 @rcontrib{Working with source code}, and @rcontrib{Compiling}.
  60
  61 @itemize
  62 @item
  63 Documentation: for large changes, see
  64 @rcontrib{Documentation work}.
  65
  66 @item
  67 Website: the website is built from the normal documentation
  68 source.  See the info about documentation, and also
  69 @rcontrib{Website work}.
  70
  71 @item
  72 Translations: see @rcontrib{Translating the documentation}, and
  73 @rcontrib{Translating the website}.
  74
  75 @item
  76 Bugfixes or new features: the best way to begin is to join the
  77 Frogs, and read @rcontrib{Programming work}.
  78
  79 @end itemize
  80
  81 @end macro
  82
  83
  84 @macro helpusProjects
  85 @subheading Projects
  86
  87 @subsubheading Frogs
  88
  89 Website and mailing list:
  90
  91 @example
  92 @uref{http://frogs.lilynet.net}
  93 @end example
  94
  95 The Frogs are ordinary LilyPond users who have chosen to get
  96 involved in their favorite software's development.  Fixing bugs,
  97 implementing new features, documenting the source code: there's a
  98 lot to be done, but most importantly: this is a chance for
  99 everyone to learn more about LilyPond, about Free Software, about
 100 programming... and to have fun.  If you're curious about any of
 101 it, then the word is: @emph{Join the Frogs!}
 102
 103
 104
 105 @subsubheading Grand LilyPond Input Syntax Standardization
 106
 107 Website:
 108 @rcontrib{Grand LilyPond Input Syntax Standardization (GLISS)}.
 109
 110 GLISS will stabilize the (non-tweak) input syntax for the upcoming
 111 LilyPond 3.0.  After updating to 3.0, the input syntax for
 112 untweaked music will remain stable for the foreseeable future.
 113
 114 We will have an extensive discussion period to determine the final
 115 input specification.
 116
 117 @warning{GLISS will start shortly after 2.14 is released.}
 118
 119 @subsubheading Grand Organizing Project
 120
 121 Website: @rcontrib{Grand Organization Project (GOP)}.
 122
 123 GOP will be our big recruiting drive for new contributors.  We
 124 desperately need to spread the development duties (including
 125 @qq{simple tasks} which require no programming or interaction with
 126 source code!) over more people.  We also need to document
 127 knowledge from existing developers so that it does not get lost.
 128
 129 Unlike most @qq{Grand Projects}, GOP is not about adding huge new
 130 features or completely redesigning things.  Rather, it is aimed at
 131 giving us a much more stable foundation so that we can move ahead
 132 with larger tasks in the future.
 133
 134 @warning{GOP will start shortly after the 2.14 release.}
 135
 136 @end macro
 137
 138