]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/included/helpus.itexi
Build: move "help us" into Documentation/included/
[lilypond.git] / Documentation / included / helpus.itexi
1 @c -*- coding: utf-8; mode: texinfo; -*-
2 @c This file is part of FIXME
3
4 @macro helpusNeed
5 @subheading We need you!
6
7 The LilyPond development team is quite small; we really want to
8 get more people involved.  Please consider helping your fellow
9 LilyPond users by contributing to development!
10
11 Even working on small tasks can have a big impact: taking care
12 of them let experienced developers work on advanced tasks, instead
13 of spending time on those simple tasks.
14
15 @end macro
16
17
18 @macro helpusTasks
19 @subheading Simple tasks
20
21 @itemize
22 @item
23 Mailing list support: answer questions from fellow users.
24
25 @item
26 Bug reporting: help users create proper @rweb{Bug reports}, and
27 aid the Bug Team in handling @rcontrib{Issues}.
28
29 @item
30 Documentation: small changes can be proposed by following the
31 guidelines for @rcontrib{Documentation suggestions}.
32
33 @item
34 LilyPond Snippet Repository (LSR): create and fix snippets.  See
35 @rcontrib{Adding and editing snippets}.
36
37 @item
38 Discussions, reviews, and testing: the developers often ask for
39 feedback about new documentation, potential syntax changes, and
40 testing new features.  Please contribute to these discussions!
41
42 @end itemize
43
44 @subheading Moderate tasks
45
46 @warning{These jobs generally require that you have the program
47 and documentation source files, but do not require a full
48 development environment.  See @rcontrib{Starting with Git}.}
49
50 @itemize
51 @item
52 Documentation: see
53 @rcontrib{Documentation work}, and
54 @rcontrib{Building documentation without compiling LilyPond}.
55
56 @item
57 Website: the website is built from the normal documentation
58 source.  See the info about documentation, and also
59 @rcontrib{Website work}.
60
61 @item
62 Translations: see @rcontrib{Translating the documentation}, and
63 @rcontrib{Translating the website}.
64
65 @end itemize
66
67
68 @subheading Complex tasks
69
70 @warning{These jobs generally require that you have the source
71 code and can compile LilyPond.  See @rcontrib{Starting with Git},
72 and @rcontrib{Compiling LilyPond}.}
73
74 We suggest that new contributors using Windows use a virtual
75 machine to run @emph{lilybuntu}.  See
76 @rcontrib{Using a Virtual Machine to Compile LilyPond}.
77
78 @itemize
79 @item
80 Bugfixes, new features: the best way to begin is to join the
81 Frogs, and read @rcontrib{Programming work}.
82
83 @end itemize
84
85 @end macro
86
87
88 @macro helpusProjects
89 @subheading Projects
90
91 @subsubheading Frogs
92
93 Website and mailist: @uref{http://frogs.lilynet.net}
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 @help{not active yet; either comment out or begin these projects
106 before 2.14}
107
108 @subsubheading Grand LilyPond Input Syntax Standardization
109
110 Website: @uref{http://lilypond.org/~graham/gliss}
111
112 GLISS will stabilize the (non-tweak) input syntax for the upcoming
113 LilyPond 3.0.  After updating to 3.0, the input syntax for
114 untweaked music will remain stable for the foreseeable future.
115
116 We will have an extensive discussion period to determine the final
117 input specification.
118
119 @subsubheading Grand Organizing Project
120
121 Website and mailist: TODO
122
123 GOP is our big recruiting drive for new contributors.
124
125
126 @end macro
127
128