]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/included/helpus.itexi
Merge branch 'master' into lilypond/translation
[lilypond.git] / 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 to development!
11
12 Even working on small tasks can have a big impact: taking care
13 of them let 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 @itemize
23 @item
24 Mailing list support: answer questions from fellow users.
25
26 @item
27 Bug reporting: help users create proper @rweb{Bug reports}, and/or
28 join the Bug Squad to organize @rcontrib{Issues}.
29
30 @item
31 Documentation: small changes can be proposed by following the
32 guidelines for @rcontrib{Documentation suggestions}.
33
34 @item
35 LilyPond Snippet Repository (LSR): create and fix snippets
36 following the guidelines in
37 @rcontrib{Adding and editing snippets}.
38
39 @item
40 Discussions, reviews, and testing: the developers often ask for
41 feedback about new documentation, potential syntax changes, and
42 testing new features.  Please contribute to these discussions!
43
44 @end itemize
45
46 @subheading Moderate tasks
47
48 @warning{These jobs generally require that you have the program
49 and documentation source files, but do not require a full
50 development environment.  See
51 @rcontrib{Working with source code}.}
52
53 @itemize
54 @item
55 Documentation: see
56 @rcontrib{Documentation work}, and
57 @rcontrib{Building documentation without compiling}.
58
59 @item
60 Website: the website is built from the normal documentation
61 source.  See the info about documentation, and also
62 @rcontrib{Website work}.
63
64 @item
65 Translations: see @rcontrib{Translating the documentation}, and
66 @rcontrib{Translating the website}.
67
68 @end itemize
69
70
71 @subheading Complex tasks
72
73 @warning{These jobs generally require that you have the source
74 code and can compile LilyPond.  See
75 @rcontrib{Working with source code},
76 and @rcontrib{Compiling}.
77 @*@*
78 We suggest that new contributors using Windows or MacOS X do
79 @strong{not} attempt to set up their own development environment;
80 instead, see
81 @rcontrib{Lilybuntu}.
82 }
83
84 @itemize
85 @item
86 Bugfixes, new features: the best way to begin is to join the
87 Frogs, and read @rcontrib{Programming work}.
88
89 @end itemize
90
91 @end macro
92
93
94 @macro helpusProjects
95 @subheading Projects
96
97 @subsubheading Frogs
98
99 Website and mailing list:
100
101 @example
102 @uref{http://frogs.lilynet.net}
103 @end example
104
105 The Frogs are ordinary LilyPond users who have chosen to get
106 involved in their favorite software's development.  Fixing bugs,
107 implementing new features, documenting the source code: there's a
108 lot to be done, but most importantly: this is a chance for
109 everyone to learn more about LilyPond, about Free Software, about
110 programming... and to have fun.  If you're curious about any of
111 it, then the word is: @emph{Join the Frogs!}
112
113
114
115 @subsubheading Grand LilyPond Input Syntax Standardization
116
117 Website:
118 @rcontrib{Grand LilyPond Input Syntax Standardization (GLISS)}.
119
120 GLISS will stabilize the (non-tweak) input syntax for the upcoming
121 LilyPond 3.0.  After updating to 3.0, the input syntax for
122 untweaked music will remain stable for the foreseeable future.
123
124 We will have an extensive discussion period to determine the final
125 input specification.
126
127 @warning{GLISS will start shortly after 2.14 is released.}
128
129 @subsubheading Grand Organizing Project
130
131 Website: @rcontrib{Grand Organization Project (GOP)}.
132
133 GOP will be our big recruiting drive for new contributors.  We
134 desperately need to spread the development duties (including
135 @qq{simple tasks} which require no programming or interaction with
136 source code!) over more people.  We also need to document
137 knowledge from existing developers so that it does not get lost.
138
139 Unlike most @qq{Grand Projects}, GOP is not about adding huge new
140 features or completely redesigning things.  Rather, it is aimed at
141 giving us a much more stable foundation so that we can move ahead
142 with larger tasks in the future.
143
144 @warning{GOP will start shortly after the 2.14 release.}
145
146 @end macro
147
148