Issue 4828/1: Allow override of NoteHead.ledger-positions

[lilypond.git] / Documentation / included / helpus.itexi

diff --git a/Documentation/included/helpus.itexi b/Documentation/included/helpus.itexi
index 3d08c278bc83f8f995ac3224dc49a150072a3d25..96f697be4cb95bbf1767356cf3a62ac2fb4ca39f 100644 (file)
--- a/Documentation/included/helpus.itexi
+++ b/Documentation/included/helpus.itexi
@@ -5,20 +5,28 @@
 @macro helpusNeed
 @subheading We need you!
 
 @macro helpusNeed
 @subheading We need you!
 

-The LilyPond development team is quite small; we really want to
-get more people involved.  Please consider helping your fellow
-LilyPond users by contributing to development!
+Thank you for your interest in helping us --- we would love to see
+you get involved!  Your contribution will help a large group of users
+make beautifully typeset music.

 
 

-Even working on small tasks can have a big impact: taking care
-of them let experienced developers work on advanced tasks, instead
+Even working on small tasks can have a big impact: taking care of
+them allows experienced developers work on advanced tasks, instead

 of spending time on those simple tasks.
 
 of spending time on those simple tasks.
 

+For a multi-faceted project like LilyPond, sometimes it's tough to know
+where to begin.  In addition to the avenues proposed below, you can send
+an e-mail to the
+@uref{https://lists.gnu.org/mailman/listinfo/lilypond-devel, lilypond-devel@@gnu.org}
+mailing list, and we'll help you to get started.
+

 @end macro
 
 
 @end macro
 
 

-@macro helpusTasks
+@macro helpusSimple

 @subheading Simple tasks
 
 @subheading Simple tasks
 

+@strong{No programming skills} required!
+

 @itemize
 @item
 Mailing list support: answer questions from fellow users.
 @itemize
 @item
 Mailing list support: answer questions from fellow users.


@@ -43,18 +51,29 @@ testing new features.  Please contribute to these discussions!
 
 @end itemize
 
 
 @end itemize
 

-@subheading Moderate tasks
+@end macro
+

 
 

-@warning{These jobs generally require that you have the program
-and documentation source files, but do not require a full
-development environment.  See
-@rcontrib{Working with source code}.}
+@macro helpusAdvanced
+@subheading Advanced tasks
+
+These jobs generally require that you have the source code and can
+compile LilyPond.
+
+@warning{We suggest that contributors using Windows or MacOS X do
+@strong{not} attempt to set up their own development environment;
+instead, use Lilydev as discussed in @rcontrib{Quick start}.}
+
+Contributors using Linux or FreeBSD may also use Lilydev, but if
+they prefer their own development environment, they should read
+@rcontrib{Working with source code}, and @rcontrib{Compiling}.
+
+Begin by reading @rcontrib{Summary for experienced developers}.

 
 @itemize
 @item
 
 @itemize
 @item

-Documentation: see
-@rcontrib{Documentation work}, and
-@rcontrib{Building documentation without compiling}.
+Documentation: for large changes, see
+@rcontrib{Documentation work}.

 
 @item
 Website: the website is built from the normal documentation
 
 @item
 Website: the website is built from the normal documentation


@@ -65,60 +84,22 @@ source.  See the info about documentation, and also
 Translations: see @rcontrib{Translating the documentation}, and
 @rcontrib{Translating the website}.
 
 Translations: see @rcontrib{Translating the documentation}, and
 @rcontrib{Translating the website}.
 

-@end itemize
-
-
-@subheading Complex tasks
-
-@warning{These jobs generally require that you have the source
-code and can compile LilyPond.  See
-@rcontrib{Working with source code},
-and @rcontrib{Compiling}.
-@*@*
-We suggest that new contributors using Windows or MacOS X do
-@strong{not} attempt to set up their own development environment;
-instead, see
-@rcontrib{Using a Virtual Machine to Compile LilyPond}.
-}
-
-@itemize

 @item
 @item

-Bugfixes, new features: the best way to begin is to join the
-Frogs, and read @rcontrib{Programming work}.
+Bugfixes or new features: read @rcontrib{Programming work}.

 
 @end itemize
 
 @end macro
 
 
 @end itemize
 
 @end macro
 

-
+@ignore

 @macro helpusProjects
 @subheading Projects
 
 @macro helpusProjects
 @subheading Projects
 

-@subsubheading Frogs
-
-Website and mailing list:
-
-@example
-@uref{http://frogs.lilynet.net}
-@end example
-
-The Frogs are ordinary LilyPond users who have chosen to get
-involved in their favorite software's development.  Fixing bugs,
-implementing new features, documenting the source code: there's a
-lot to be done, but most importantly: this is a chance for
-everyone to learn more about LilyPond, about Free Software, about
-programming... and to have fun.  If you're curious about any of
-it, then the word is: @emph{Join the Frogs!}
-
-

 
 @subsubheading Grand LilyPond Input Syntax Standardization
 
 Website:
 
 @subsubheading Grand LilyPond Input Syntax Standardization
 
 Website:

-
-@example
-@uref{http://lilypond.org/~graham/gliss}
-@end example
+@rcontrib{Grand LilyPond Input Syntax Standardization (GLISS)}.

 
 GLISS will stabilize the (non-tweak) input syntax for the upcoming
 LilyPond 3.0.  After updating to 3.0, the input syntax for
 
 GLISS will stabilize the (non-tweak) input syntax for the upcoming
 LilyPond 3.0.  After updating to 3.0, the input syntax for


@@ -127,15 +108,11 @@ untweaked music will remain stable for the foreseeable future.
 We will have an extensive discussion period to determine the final
 input specification.
 
 We will have an extensive discussion period to determine the final
 input specification.
 

-@warning{GLISS will start shortly after 2.14 is released.}
+@warning{GLISS will start shortly after 2.16 is released.}

 
 @subsubheading Grand Organizing Project
 
 
 @subsubheading Grand Organizing Project
 

-Website:
-
-@example
-@uref{http://lilypond.org/~graham/gop}
-@end example
+Website: @rcontrib{Grand Organization Project (GOP)}.

 
 GOP will be our big recruiting drive for new contributors.  We
 desperately need to spread the development duties (including
 
 GOP will be our big recruiting drive for new contributors.  We
 desperately need to spread the development duties (including


@@ -148,9 +125,7 @@ features or completely redesigning things.  Rather, it is aimed at
 giving us a much more stable foundation so that we can move ahead
 with larger tasks in the future.
 
 giving us a much more stable foundation so that we can move ahead
 with larger tasks in the future.
 

-@warning{GOP will start shortly before or after the 2.14
-release.}
-

 @end macro
 
 @end macro
 

+@end ignore