]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/web/community.itexi
Release: update news.
[lilypond.git] / Documentation / web / community.itexi
index a7a59c97da8b1e054190aa5b06834f3596e7e999..25c9fa88b5496993d5474be408ac188ebb3a0a53 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
@@ -400,145 +402,34 @@ 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
 
 @divClass{heading-center}
-@heading Development materials for LilyPond @versionDevel{}
+@ifclear web_version
+  @heading Development for LilyPond @version
+@end ifclear
+@ifset web_version
+  @heading Development for LilyPond @versionDevel
+@end ifset
+
 
 @warning{These are @emph{unstable development} versions.  If you
 have the slightest doubt about how to use or install LilyPond, we
@@ -599,12 +490,11 @@ the latest binary:
 @divClass{column-right-top}
 @subheading Contributor's Guide
 
-LilyPond development is a fairly complicated matter.  LilyPond is
-a large, (mostly) stable project.  In order to help new
-contributors, and to keep the whole system (mostly) stable, we
-have written a manual for contributors.
+LilyPond development is a fairly complicated matter.  In order to
+help new contributors, and to keep the whole system (mostly)
+stable, we have written a manual for development tasks.
 
-@docLinks{Contributor's Guide, contributor,
+@docLinksBare{Contributor's Guide, contributor,
   @rcontribnamed{Top,Contributor's Guide},
   @manualDevelContributorSplit,
   @manualDevelContributorBig, 500 kB,
@@ -613,22 +503,35 @@ have written a manual for contributors.
 @divEnd
 
 
-@c if Downloads was a bit longer, and/or the CG was a bit shorter,
-@c this would be great as column-right-top.  -gp
 @divClass{column-center-top}
 @subheading Regression tests
 
 @divClass{keep-bullets}
 @itemize
 
-@item @uref{../../input/regression/collated-files.html, Regression tests}:
-This release's tests.  (also in
-@uref{../input/regression/collated-files.pdf, pdf})
+@ifclear web_version
+
+@item
+@uref{../../input/regression/collated-files.html, Regression tests}:
+This release's regtests.
+(@uref{../../input/regression/collated-files.pdf, pdf version})
+
+@item
+@uref{../../input/regression/musicxml/collated-files.html, MusicXML tests}:
+This release's musicXML tests.
+(@uref{../../input/regression/musicxml/collated-files.pdf, pdf version})
+@end ifclear
+
+@ifset web_version
+@item @regtestDevel (@regtestDevelPdf{})
+
+@item @regtestDevelXml (@regtestDevelXmlPdf{})
+
+@item @regtestStable (@regtestStablePdf{})
+
+@item @regtestStableXml (@regtestStableXmlPdf{})
+@end ifset
 
-@item @uref{../../input/regression/musicxml/collated-files.html,
-MusicXML Regression tests}:
-This release's MusicXML tests.  (also in
-@uref{../input/regression/musicxml/collated-files.pdf, pdf})
 
 @item @uref{http://lilypond.org/test, Archive of regression tests}:
 Comparisons between versions.
@@ -642,82 +545,94 @@ Comparisons between versions.
 @divClass{column-center-bottom}
 @subheading Manuals
 
+@ifclear web_version
+@warning{These manuals are for LilyPond @version{}; the latest
+manuals can be found at @url{http://lilypond.org}}
+@end ifclear
+
 @divClass{normal-table}
 @multitable @columnfractions .3 .3 .3
 @headitem Introduction
 @item
-@manualDevelLearningSplit
+@docLinkSplit{Learning,learning,@manualDevelLearningSplit}
 @tab
-@manualDevelLearningBig
+@docLinkBig{Learning,learning,@manualDevelLearningBig}
 @tab
-@manualDevelLearningPdf
+@docLinkPdf{Learning,learning,@manualDevelLearningPdf}
 
 @item
-@manualDevelGlossarySplit
+@docLinkSplit{Glossary,music-glossary,@manualDevelGlossarySplit}
 @tab
-@manualDevelGlossaryBig
+@docLinkBig{Glossary,music-glossary,@manualDevelGlossaryBig}
 @tab
-@manualDevelGlossaryPdf
+@docLinkPdf{Glossary,music-glossary,@manualDevelGlossaryPdf}
 
 @item
-@manualDevelEssaySplit
+@docLinkSplit{Essay,essay,@manualDevelEssaySplit}
 @tab
-@manualDevelEssayBig
+@docLinkBig{Essay,essay,@manualDevelEssayBig}
 @tab
-@manualDevelEssayPdf
+@docLinkPdf{Essay,essay,@manualDevelEssayPdf}
 
 @headitem Regular
 
 @item
-@manualDevelNotationSplit
+@docLinkSplit{Notation,notation,@manualDevelNotationSplit}
 @tab
-@manualDevelNotationBig
+@docLinkBig{Notation,notation,@manualDevelNotationBig}
 @tab
-@manualDevelNotationPdf
+@docLinkPdf{Notation,notation,@manualDevelNotationPdf}
 
 @item
-@manualDevelUsageSplit
+@docLinkSplit{Usage,usage,@manualDevelUsageSplit}
 @tab
-@manualDevelUsageBig
+@docLinkBig{Usage,usage,@manualDevelUsageBig}
 @tab
-@manualDevelUsagePdf
+@docLinkPdf{Usage,usage,@manualDevelUsagePdf}
 
 @item
-@manualDevelSnippetsSplit
+@docLinkSplit{Snippets,snippets,@manualDevelSnippetsSplit}
 @tab
-@manualDevelSnippetsBig
+@docLinkBig{Snippets,snippets,@manualDevelSnippetsBig}
 @tab
-@manualDevelSnippetsPdf
+@docLinkPdf{Snippets,snippets,@manualDevelSnippetsPdf}
 
 @headitem Infrequent
 
 @item
-@manualDevelWebSplit
+@docLinkSplit{Web,web,@manualDevelWebSplit}
 @tab
-@manualDevelWebBig
+@docLinkBig{Web,web,@manualDevelWebBig}
 @tab
-@manualDevelWebPdf
+@docLinkPdf{Web,web,@manualDevelWebPdf}
 
 @item
-@manualDevelChangesSplit
+@docLinkSplit{Changes,changes,@manualDevelChangesSplit}
 @tab
-@manualDevelChangesBig
+@docLinkBig{Changes,changes,@manualDevelChangesBig}
 @tab
-@manualDevelChangesPdf
+@docLinkPdf{Changes,changes,@manualDevelChangesPdf}
 
 @item
-@manualDevelExtendingSplit
+@docLinkSplit{Extending,extending,@manualDevelExtendingSplit}
 @tab
-@manualDevelExtendingBig
+@docLinkBig{Extending,extending,@manualDevelExtendingBig}
 @tab
-@manualDevelExtendingPdf
+@docLinkPdf{Extending,extending,@manualDevelExtendingPdf}
 
 @item
-@manualDevelInternalsSplit
+@docLinkSplit{Internals,internals,@manualDevelInternalsSplit}
 @tab
-@manualDevelInternalsBig
+@docLinkBig{Internals,internals,@manualDevelInternalsBig}
 @tab
-@manualDevelInternalsPdf
+@docLinkPdf{Internals,internals,@manualDevelInternalsPdf}
+
+@ifset web_version
+@headitem Downloadable
+
+@item
+@doctarballDevel
+@end ifset
 
 @end multitable
 
@@ -766,6 +681,10 @@ Comparisons between versions.
 
 @docCurrent
 
+@subsubheading Bug squad
+
+@bugsquadCurrent
+
 @subsubheading Support
 
 @supportCurrent
@@ -794,6 +713,11 @@ Comparisons between versions.
 
 @docPrevious
 
+@c    uncomment when we have any previous members -gp
+@c @subsubheading Bug squad
+
+@c @bugsquadCurrent
+
 @subsubheading Support
 
 @supportPrevious
@@ -824,7 +748,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})
@@ -883,7 +807,7 @@ December 2005
 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
+Kris Shaffer remarks @qq{GNU LilyPond generates beautiful graphics
 that make commercial alternatives seem second-rate.}
 
 @item