]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/web/community.itexi
Merge branch 'master' into lilypond/translation
[lilypond.git] / Documentation / web / community.itexi
index 03257ca63ac0ab7ac07bec52799741e3d3876b03..a9ae0ed3fabc1bc4d42dacb5007262eb55a5743c 100644 (file)
@@ -3,10 +3,12 @@
     Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
 
     When revising a translation, copy the HEAD committish of the
-    version that you are working on.  See TRANSLATION for details.
+    version that you are working on.  For details, see the Contributors'
+    Guide, node Updating translation committishes..
 @end ignore
 
-@include web/basic-authors.itexi
+@include included/authors.itexi
+@include included/helpus.itexi
 
 @node Community
 @unnumbered Community
@@ -105,6 +107,20 @@ send to lilypond-user with gmane}
 
 @warning{When asking questions, please use @ref{Tiny examples}!}
 
+@subsubheading LilyPond Snippet Repository
+
+The LilyPond Snippet Repository is a large collection of
+user-submitted examples, which can freely be copied and used
+in your owm works.  See what other people have written,
+and add your own!
+
+@example
+@uref{http://lsr.dsi.unimi.it}
+@end example
+
+Particularly instructive examples from LSR are included in our
+official documentation, in @ref{Snippets}.
+
 
 @subsubheading IRC
 
@@ -168,7 +184,11 @@ Dutch forum}
 @subsubheading LilyPond Report
 
 The easiest way to keep touch is by reading our community
-newsletter, the @uref{http://news.lilynet.net/, LilyPond Report}.
+newsletter, the LilyPond Report:
+
+@example
+@uref{http://news.lilynet.net}
+@end example
 
 @subsubheading Releases mailing list: @code{info-lilypond@@gnu.org}
 
@@ -342,9 +362,9 @@ free to add more information to that report.}
 If you have discovered a bug which is not listed, please help us
 by creating a bug report.
 
-@warning{We only accept bug reports in the form of @ref{Tiny
-examples}.  We have very limited resources to deal with bug
-reports, so any non-minimal example will be rejected.  Almost
+@warning{We only accept bug reports in the form of
+@ref{Tiny examples}.  We have very limited resources to deal with
+bug reports, so any non-minimal example will be rejected.  Almost
 every bug can be demonstrated in four notes or less!}
 
 Here is an example of a good bug report:
@@ -354,7 +374,6 @@ Here is an example of a good bug report:
 %% change the output at all!
 
 \version "2.10.0"
-\paper@{ ragged-right=##t @}
 \relative c''' @{
   c1
   #(set-octavation 1)
@@ -370,25 +389,39 @@ Here is an example of a good bug report:
 Once you have verified that the issue is not already known and
 created a bug report, please send it to us!
 
-Unfortunately there is a strict @qq{no top-posting} check on the
-bug list, which is often incorrectly triggered by lilypond files.
-To avoid this, please add
+@divClass{keep-bullets}
+@itemize
+
+@item
+If you are subscribed to the @uref{mailto:bug-lilypond@@gnu.org,
+bug-lilypond@@gnu.org} mailing list, send an email like normal.
+
+@item
+If you are not subscribed, you can still post a bug report with
+the
+@uref{http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs,
+gmane lilypond.bugs web interface}.
+
+However, there is a strict @qq{no top-posting} check on the gmane
+interface, which is often incorrectly triggered by lilypond files.
+To avoid this, please add:
 
 @example
 > I'm not top posting.
 @end example
 
 @noindent
-(you must include the @code{>} ) to the top of your bug report.
+(you @emph{must} include the @code{>} ) to the top of your bug
+report.
 
-@uref{http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs,
-Post with the gmane lilypond.bugs interface}, or send an email to
-@uref{mailto:bug-lilypond@@gnu.prg, bug-lilypond@@gnu.org}.
+@end itemize
+@divEnd
 
-Once your bug has been sent to the list, our Bug Meister will
-examine the report.  He may ask you for more information, or may
-add the report to the tracker and let you know what the issue
-number is.
+Once your bug has been sent to the list, our Bug Squad will
+examine the report.  Please allow up to 24 hours, as we have a
+limited number of volunteers for this task.  They may ask you for
+more information, or may add the report to the tracker and let you
+know what the issue number is.
 
 You may mark the bug so that you automatically receive emails when
 any activity on the bug occurs.  This requires you have a google
@@ -400,140 +433,23 @@ account.
 @unnumberedsec Help us
 
 @divClass{column-center-top}
-@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!
-
-Even working on small tasks can have a big impact: taking care
-of them let experienced developers work on advanced tasks, instead
-of spending time on those simple tasks.
+@helpusNeed
 
 @divEnd
 
-
 @divClass{column-left-top}
-@subheading Simple tasks
-
 @divClass{keep-bullets}
-
-@itemize
-@item
-Mailing list support: answer questions from fellow users.
-
-@item
-Bug reporting: help users create proper @ref{Bug reports}, and aid
-the Bug Team in handling @rcontrib{Issues}.
-
-@item
-Documentation: small changes can be proposed by following the
-guidelines for @rcontrib{Documentation suggestions}.
-
-@item
-LilyPond Snippet Repository (LSR): create and fix snippets.  See
-@rcontrib{Adding and editing snippets}.
-
-@item
-Discussions, reviews, and testing: the developers often ask for
-feedback about new documentation, potential syntax changes, and
-testing new features.  Please contribute to these discussions!
-
-@end itemize
-
-@subheading Moderate tasks
-
-@warning{These jobs generally require that you have the program
-and documentation source files, but do not require a full
-development environment.  See @rcontrib{Starting with Git}.}
-
-@itemize
-@item
-Documentation: see
-@rcontrib{Documentation work}, and
-@rcontrib{Building documentation without compiling LilyPond}.
-
-@item
-Website: the website is built from the normal documentation
-source.  See the info about documentation, and also
-@rcontrib{Website work}.
-
-@item
-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{Starting with Git},
-and @rcontrib{Compiling LilyPond}.}
-
-We suggest that new contributors using Windows use a virtual
-machine to run @emph{lilybuntu}.  See
-@rcontrib{Using a Virtual Machine to Compile LilyPond}.
-
-@itemize
-@item
-Bugfixes, new features: the best way to begin is to join the
-Frogs, and read @rcontrib{Programming work}.
-
-@end itemize
+@helpusTasks
 
 @divEnd
 @divEnd
 
-
 @divClass{column-right-top}
-@subheading Projects
-
-@subsubheading Frogs
-
-Website and mailist: @uref{http://frogs.lilynet.net}
-
-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!}
-
-
-
-@help{not active yet; either comment out or begin these projects
-before 2.14}
-
-@subsubheading Grand LilyPond Input Syntax Standardization
-
-Website: @uref{http://lilypond.org/~graham/gliss}
-
-GLISS will stabilize the (non-tweak) input syntax for the upcoming
-LilyPond 3.0.  After updating to 3.0, the input syntax for
-untweaked music will remain stable for the foreseeable future.
-
-We will have an extensive discussion period to determine the final
-input specification.
-
-@subsubheading Grand Organizing Project
-
-Website and mailist: TODO
-
-GOP is our big recruiting drive for new contributors.
+@helpusProjects
 
 @divEnd
 
 
-@ignore
-@divClass{column-center-bottom}
-@subheading Interested?
-
-@divEnd
-@end ignore
-
-
 @node Development
 @unnumberedsec Development
 
@@ -628,12 +544,12 @@ stable, we have written a manual for development tasks.
 
 @item
 @uref{../../input/regression/collated-files.html, Regression tests}:
-This releases' regtests.
+This release's regtests.
 (@uref{../../input/regression/collated-files.pdf, pdf version})
 
 @item
 @uref{../../input/regression/musicxml/collated-files.html, MusicXML tests}:
-This releases' musicXML tests.
+This release's musicXML tests.
 (@uref{../../input/regression/musicxml/collated-files.pdf, pdf version})
 @end ifclear
 
@@ -760,9 +676,6 @@ manuals can be found at @url{http://lilypond.org}}
 @node Authors
 @unnumberedsec Authors
 
-@help{Under construction; this is not an accurate list!}
-
-
 @divClass{column-left-top}
 @subheading Current Development Team
 
@@ -796,6 +709,10 @@ manuals can be found at @url{http://lilypond.org}}
 
 @docCurrent
 
+@subsubheading Bug squad
+
+@bugsquadCurrent
+
 @subsubheading Support
 
 @supportCurrent
@@ -824,6 +741,11 @@ manuals can be found at @url{http://lilypond.org}}
 
 @docPrevious
 
+@c    uncomment when we have any previous members -gp
+@c @subsubheading Bug squad
+
+@c @bugsquadCurrent
+
 @subsubheading Support
 
 @supportPrevious
@@ -841,7 +763,7 @@ manuals can be found at @url{http://lilypond.org}}
 @unnumberedsec Publications
 
 @divClass{column-center-top}
-@subheading What we wrote
+@subheading What we wrote about LilyPond
 
 @divClass{keep-bullets}
 @itemize
@@ -854,7 +776,7 @@ PDF 1095k})
 
 @item
 Erik Sandberg, @emph{Separating input language and formatter in
-GNU Lilypond}. Master's Thesis, Uppsala University, Department of
+GNU LilyPond}. Master's Thesis, Uppsala University, Department of
 Information Technology March 2006.
 (@uref{http://lilypond.org/web/images/thesis-erik-sandberg.pdf,
 PDF 750k})
@@ -873,105 +795,36 @@ on Musical Informatics (XIV CIM 2003), Firenze, Italy, May 2003.
 
 @divClass{column-center-bottom}
 
-@subheading What others wrote
+@subheading What people did with LilyPond
+
 
 @divClass{keep-bullets}
 @itemize
 
 @item
-September 2009
-
-The German LinuxUser magazine wrote an
-@uref{http://www.linux-community.de/Internal/Artikel/Print-Artikel/LinuxUser/2009/10/Digitaler-Notenschluessel,
-article about LilyPond}.
-
-
-@item
-February 2008
-
-In @uref{http://www.musicbyandrew.ca/finale-lilypond-1.html,
-articles on his personal site}, Andrew Hawryluk compares Finale
-and LilyPond in general terms, and evaluates engraving
-capabilities of both pieces of software in detail.  The second
-article is an instructive analysis of engraving issues in
-Rachmaninoff's Piano Prelude No. 6, including comparisons with a
-hand-engraved reference edition.
-
-@item
-June 2006
-
-@uref{http://distrowatch.com,DistroWatch} awards LilyPond and
-@uref{http://distrowatch.com/weekly.php?issue=20060605,writes}
-@qq{Ladies and Gentleman, we are pleased to announce that, based
-on readers' requests, the DistroWatch May 2006 donation has been
-awarded to LilyPond (@euro{}190.00) and Lua (US$250.00).}
-
-@item
-December 2005
-
-@uref{http://linuxjournal.com,Linux Journal} publishes an article
-titled @uref{http://www.linuxjournal.com/article/8364, Make
-Stunning Schenker Graphs with GNU LilyPond}.  It is an in-depth
-but hands-on feature article with crisp LilyPond graphics.  Author
-Kris Shaffer remarks @qq{GNU Lilypond generates beautiful graphics
-that make commercial alternatives seem second-rate.}
+Graham Percival, Tosten Anders, and George Tzanetakis,
+@emph{Generating Targeted Rhythmic Exercises for Music Students
+with Constraint Satisfaction Programming}, International Computer
+Music Conference 2008.
 
 @item
-August 20, 2005
-
-The Belgian newspaper De Standaard investigates what drives Free
-Software authors in an article titled
-@uref{http://www.standaard.be/Artikel/Detail.aspx?artikelId=G42H5GD6,
-Delen van KENNIS zonder WINSTBEJAG} (Non-profit sharing of
-knowlegde) in its @q{DS2 bijlage}.  LilyPond is used as an example
-and the article is interspersed with quotes from an email
-interview with Jan Nieuwenhuizen. This marks LilyPond's first
-appearance in mainstream printed press.
+Alexandre Tachard Passos, Marcos Sampaio, Pedro Kröger, Givaldo de Cidra,
+@emph{Functional Harmonic Analysis and Computational Musicology
+in Rameau}, Proceedings of the 12th Brazilian Symposium on Computer
+Music, 2009, pp. 207-210.
 
 @item
-June 2005
-
-A French article on the LilyPond 2.6 release appeared on
-@uref{http://linuxfr.org/2005/06/27/19210.html, linuxfr.org}.
+Alberto Simões, Anália Lourenço and José João Almeida,
+@emph{Using Text Mining Techniques for Classical Music Scores Analysis},
+New Trends in Artificial Intelligence, 2007 J. Neves et al ed.
 
 @item
-October 2004
-
-The editors of Computer!Totaal, a Dutch computer magazine,
-@uref{http://lilypond.org/web/images/computer-totaal.jpeg,
-describe LilyPond} in the October 2004 issue as: @qq{Wonderful
-free (open source) software [..] The sheet music produced by
-LilyPond is exceptionally pretty [..] a very powerful system that
-can do almost anything.}
 
-@item
-July, August 2004
-
-Dave Phillips wrote an introductory article for
-@uref{http://linuxjournal.com,Linux Journal}: At
-the sounding edge: LilyPond, parts
-@uref{http://www.linuxjournal.com/article/7657, one} and
-@uref{http://www.linuxjournal.com/article/7719, two}.
-
-@item
-March 2004
-
-Chris Cannam
-@uref{http://www.all-day-breakfast.com/cannam/linux-musician/lilypond.html,interviewed}
-Han-Wen Nienhuys and Jan Nieuwenhuizen on linuxmusician.com
-(original site defunct).  This interview was also reviewed in a
-@uref{http://slashdot.org/article.pl?sid=04/03/13/2054227&tid=,
-slashdot story}.
-
-@item
-February 2004
+Kevin C. Baird 2005,
+@emph{Real-time generation of music notation via audience interaction using
+python and GNU lilypond}. Proceedings of the 2005 Conference on New interfaces
+For Musical Expression (Vancouver, Canada, May 26 - 28, 2005).
 
-Jazz singer Gail Selkirk writes about
-@uref{http://www.songbirdofswing.com/editorial_page/lilypond/,
-Diving into LilyPond}.  @qq{... you can make lead sheets or full
-orchestral parts, and the results can be stunning.}
-@uref{http://www.computermusic.co.uk/, Computer Music Special},
-issue CMS06.
 
 @end itemize