]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/web/community.itexi
Web&CG: remove "projects" from HelpUs
[lilypond.git] / Documentation / web / community.itexi
index 17add435ab5d6e631c4b2aba3789203ffd91ab53..a6af03f96cd7ac64de4cdbe6f4f711b575209de5 100644 (file)
@@ -3,14 +3,17 @@
     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
 
+@divClass{link-headings}
 
 @divClass{column-center-top}
 @subheading Interacting with the community
@@ -38,6 +41,9 @@ discussing LilyPond.
 @item
 @ref{Help us}: your assistance is requested.
 
+@item
+@ref{Sponsoring}: financial contributions.
+
 @item
 @ref{Development}: for contributors and testers.
 
@@ -61,6 +67,7 @@ discussing LilyPond.
 @end itemize
 @divEnd
 
+@divEnd
 
 @divClass{hide}
 @menu
@@ -68,6 +75,7 @@ discussing LilyPond.
 * Tiny examples::
 * Bug reports::
 * Help us::
+* Sponsoring::
 * Development::
 * Authors::
 * Publications::
@@ -89,10 +97,10 @@ This mailing list is the main place for users to discuss and help
 each other.
 
 @quotation
-@uref{http://mail.gnu.org/mailman/listinfo/lilypond-user,
+@uref{http://lists.gnu.org/mailman/listinfo/lilypond-user,
 lilypond-user subscribe and info}
 
-@uref{http://mail.gnu.org/archive/html/lilypond-user/,
+@uref{http://lists.gnu.org/archive/html/lilypond-user/,
 user archive1}
 @uref{http://www.mail-archive.com/lilypond-user@@gnu.org/,
 archive2}
@@ -105,6 +113,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 own 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
 
@@ -150,7 +172,7 @@ Spanish mailing list}
 German forum}
 
 @uref{http://groups.google.com/group/lilypond-brasil,
-Portugese group}
+Portuguese group}
 
 @uref{http://lists.gnu.org/mailman/listinfo/lilypond-user-fr,
 French mailing list}
@@ -168,7 +190,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}
 
@@ -179,7 +205,7 @@ notifications of new releases.
 @uref{http://lists.gnu.org/mailman/listinfo/info-lilypond,
 info-lilypond subscribe and info}
 
-@uref{http://mail.gnu.org/archive/html/info-lilypond/,
+@uref{http://lists.gnu.org/archive/html/info-lilypond/,
 info archive1}
 @uref{http://www.mail-archive.com/info-lilypond@@gnu.org/,
 archive2}
@@ -202,10 +228,10 @@ Most developer discussion takes place on this list.  Patches
 should be sent here.
 
 @quotation
-@uref{http://mail.gnu.org/mailman/listinfo/lilypond-devel,
+@uref{http://lists.gnu.org/mailman/listinfo/lilypond-devel,
 lilypond-devel subscribe and info}
 
-@uref{http://mail.gnu.org/archive/html/lilypond-devel/,
+@uref{http://lists.gnu.org/archive/html/lilypond-devel/,
 devel archive1}
 @uref{http://www.mail-archive.com/lilypond-devel@@gnu.org/,
 archive2}
@@ -222,10 +248,10 @@ send to lilypond-devel with gmane}
 Bug-specific discussion takes place here.
 
 @quotation
-@uref{http://mail.gnu.org/mailman/listinfo/bug-lilypond,
+@uref{http://lists.gnu.org/mailman/listinfo/bug-lilypond,
 bug-lilypond subscribe and info}
 
-@uref{http://mail.gnu.org/archive/html/bug-lilypond/,
+@uref{http://lists.gnu.org/archive/html/bug-lilypond/,
 bug archive1}
 @uref{http://www.mail-archive.com/bug-lilypond@@gnu.org/,
 archive2}
@@ -240,6 +266,13 @@ guidelines for @ref{Bug reports}.}
 
 @divEnd
 
+@divClass{column-right-bottom}
+@subheading Sensitive emails
+
+Private matters should be sent to Graham Percival (project
+manager), who will discuss it with those concerned.
+
+@divEnd
 
 
 @node Tiny examples
@@ -248,7 +281,7 @@ guidelines for @ref{Bug reports}.}
 @divClass{column-center-top}
 @subheading What are @qq{Tiny examples}?
 
-A tiny example is an example from which nothing can be removed.
+A tiny example is an example from which @strong{nothing} can be removed.
 @divEnd
 
 @divClass{column-left-bottom}
@@ -262,12 +295,12 @@ The simpler the example is, the quicker potential helpers can
 understand it and help you.
 
 @item
-A simple example demonstrates that you have put effort towards
+A tiny example demonstrates that you have put effort towards
 solving the problem yourself.  When people send huge portions of
-input, it looks like they don't care how if we help them or not.
+input, it looks like they don't care if we help them or not.
 
 @item
-Creating a tiny example forces you to understand what is
+Creating a tiny example helps you to understand what is
 happening.  Many false problem reports can be avoided by
 attempting to create a tiny example; if you cannot replicate a
 @qq{bug} in a tiny example, then the problem was probably an
@@ -280,39 +313,78 @@ insufficient understanding of LilyPond, not an actual bug!
 
 
 @divClass{column-right-bottom}
-@subheading How do I create them?
+@subheading How to create them?
 
 @divClass{keep-bullets}
 @itemize
 
 @item
-Include the \version number.
+Include the @code{\version} number.
 
 @item
 Make it small!  Examples about spacing or page layout might
 require many bars of music, but most issues can be reproduced
-using only a single measure.
+using less than a single measure.
 
 @item
 When trying to create an example, try commenting out @w{(@code{%}
-or @code{%@{ @dots{} %@}})} sections of your file.  If you can
-comment something while still demonstrating the main idea, then
-remove the commented-material!
+or @code{%@{ @dots{} %@}})} sections of your file.  If you
+can comment something while still demonstrating the main idea,
+then remove the commented-material.
 
 @item
-Avoid using complicated notes, keys, or time signatures, unless
+Avoid using complicated notes, keys or time signatures, unless
 the bug is about the behavior of those items.
 
 @item
 Do not use @code{\override} or @code{\set} commands unless the bug
-is about those particular commands.
+is about those specific commands.
+
+@item
+Optionally, attach an image showing the desired graphical output.
 
 @end itemize
 @divEnd
 
 @divEnd
 
+@divClass{column-center-bottom}
+@subheading How tiny should they be?
+
+Is the code below a minimal example?
+
+@example
+\version "2.14.1"
+\include "english.ly"
+
+\score @{
+  \new Staff @{
+    \key d \major
+    \numericTimeSignature
+    \time 2/4
+    <cs' d'' b''>16 <cs' d'' b''>8.
+    %% Here: the tie on the D's looks funny
+    %% Too tall? Left-hand endpoint is not aligned with the B tie?
+    ~
+    <cs' d'' b''>8 [ <b d'' a''> ]
+  @}
+@}
+@end example
+
+Well, it is not very big, but a truly minimal example is here:
+
+@example
+\version "2.14.1"
+@{
+  % middle tie looks funny here:
+  <c' d'' b''>8. ~ <c' d'' b''>8
+@}
+@end example
+
+Very few tiny examples exceed 10 lines of code -
+quite often 4 lines are enough to demonstrate the problem!
 
+@divEnd
 
 
 @node Bug reports
@@ -342,23 +414,22 @@ 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:
 
 @example
-%% the octavation command doesn't
-%% change the output at all!
-
-\version "2.10.0"
-\paper@{ ragged-right=##t @}
-\relative c''' @{
-  c1
-  #(set-octavation 1)
-  c1
+% Accidentals should be printed for only
+% the first note in a tie, but this version
+% prints flats on both notes.
+\version "2.10.1"
+
+\relative c'' @{
+ bes1 ~
+ bes1
 @}
 @end example
 
@@ -370,180 +441,180 @@ 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
+@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.
+@divClass{column-center-bottom}
+@subheading Step 4: Wait for a response
+
+Once your bug has been sent to the list, our Bug Squad will
+examine the report.  Please allow up to 4 days, 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
 account.
 @divEnd
 
+@divClass{column-center-bottom}
+@subheading Optional help: show the desired behavior
+
+Once an issue has been added to the tracker, it can be very
+helpful if we can see the desired output.  Feel free to add input
+code and/or images (possibly created with other tools) which
+demonstrate what you think it should look like!
+
+@divEnd
+
+
 
 @node Help us
 @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}
+@helpusSimple
 
-@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}.
+@divEnd
+@divEnd
 
-@item
-Documentation: small changes can be proposed by following the
-guidelines for @rcontrib{Documentation suggestions}.
+@divClass{column-right-top}
+@helpusAdvanced
 
-@item
-LilyPond Snippet Repository (LSR): create and fix snippets.  See
-@rcontrib{Adding and editing snippets}.
+@divEnd
 
-@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
+@node Sponsoring
+@unnumberedsec Sponsoring
 
-@subheading Moderate tasks
+@divClass{keep-bullets}
+@divClass{column-left-top}
+@subheading Bounties
 
-@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}.}
+In the past,
 
 @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}.
-
+@item some users have paid for new features
+@item some developers have added new features for hire
 @end itemize
 
+The LilyPond project does not organize such efforts; we neither
+endorse nor discourage such agreements.  Any contracts between
+private individuals is the business of those individuals, not
+ours.
 
-@subheading Complex tasks
+@divEnd
 
-@warning{These jobs generally require that you have the source
-code and can compile LilyPond.  See @rcontrib{Starting with git},
-and @rcontrib{Compiling LilyPond}.}
+@divClass{column-right-top}
+@subheading Guidelines
 
-We suggest that new contributors using Windows use a virtual
-machine to run @emph{lilybuntu}.  See
-@rcontrib{Using a Virtual Machine to Compile LilyPond}.
+Any user wanting to offer money in exchange for work should bear
+in mind the following points:
 
 @itemize
 @item
-Bugfixes, new features: the best way to begin is to join the
-Frogs, and read @rcontrib{Programming work}.
+LilyPond developers may advertise their services on the lilypnod
+email lists from time to time.
+
+@item
+Any agreements between private individuals should include the
+normal precautions when conducting business: who pays, how much do
+they pay, with what method of payment, and upon what set of
+conditions.  We suggest that any ambiguity or uncertainty in these
+questions should be resolved before any work begins.
 
 @end itemize
 
 @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!}
-
 
+@divClass{column-center-bottom}
+@subheading Interested developers
 
-@help{not active yet; either comment out or begin these projects
-before 2.14}
-
-@subsubheading Grand LilyPond Input Syntax Standardization
-
-Website and mailist: TODO
+Here is a list of people who have expressed an interest in
+bounties.  Note that the amount of work done by individuals varies
+quite a bit throughout the years.  We do not guarantee that this
+list is up-to-date, nor do we guarantee that the people listed
+here have any ability.  The only criteria is "XYZ asked to be
+listed on this page".
 
-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.
+Looking at the git history is a good way to determine who the most
+active and experienced developers are.  Statistics up to version
+@versionDevel{}:
 
-We will have an extensive discussion period to determine the final
-input specification.
+@multitable @columnfractions .3 .3 .3
+@item @uref{http://lilypond.org/~graham/gitstats-all/, overall history}
+@tab @uref{http://lilypond.org/~graham/gitstats-1year/, past year}
+@tab @uref{http://lilypond.org/~graham/gitstats-3months/, past three months}
+@end multitable
 
-@subsubheading Grand Organizing Project
+Interested developers:
+@table @asis
+@item @email{dak@@gnu.org, David Kastrup}
+Donations are required to let me continue my current fulltime work on
+LilyPond.  I focus on user and programmer interface design, coherence,
+implementation, simplification, documentation, and debugging.
 
-Website and mailist: TODO
+@c Format
+@c @item @email{name@@adress.domain, Name}
+@c area of interest (256 chars max)
 
-GOP is our big recruiting drive for new contributors.
+@end table
 
 @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
+
 
+@c we normally don't allow named references, but in this case
+@c it's good to emphasize the "stable" part.  -gp
 @warning{These are @emph{unstable development} versions.  If you
 have the slightest doubt about how to use or install LilyPond, we
-urge you to use the stable @ref{Download}, and read the stable
-@ref{Manuals}.}
+urge you to use the @ref{Download, stable Download}, and read the
+@ref{Manuals, stable Manuals}.}
 
 @divEnd
 
@@ -559,7 +630,7 @@ Development versions have an odd-numbered @q{minor} version number
 @divEnd
 
 
-@divClass{column-left-bottom}
+@divClass{column-left-top}
 @subheading Download
 
 Instructions for git and compiling are in the Contributor's Guide.
@@ -593,176 +664,201 @@ the latest binary:
 
 @end quotation
 
+@divEnd
 
-@subheading Manuals
-
-@divClass{keep-bullets}
-@itemize
-
-@item
-Learning:
-
-@manualDevelLearningSplit
-@* @manualDevelLearningBig
-@* @manualDevelLearningPdf
-
-@item
-Glossary:
-
-@manualDevelGlossarySplit
 
-@manualDevelGlossaryBig
+@divClass{column-right-top}
+@subheading Contributor's Guide
 
-@manualDevelGlossaryPdf
+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.
 
-@item
-Essay:
+@docLinksBare{Contributor's Guide, contributor,
+  @rcontribnamed{Top,Contributor's Guide},
+  @manualDevelContributorSplit,
+  @manualDevelContributorBig, 500 kB,
+  @manualDevelContributorPdf, 2.8 MB}
 
-@manualDevelEssaySplit
+@divEnd
 
-@manualDevelEssayBig
 
-@manualDevelEssayPdf
+@divClass{column-center-top}
+@subheading Regression tests
 
+@divClass{keep-bullets}
 
-@c separate introduction, regular, infrequent manuals
-@smallspace
+@ifclear web_version
 
+@itemize
 @item
-Notation:
+@uref{../../input/regression/collated-files.html, Regression tests}:
+This release's regtests.
+(@uref{../../input/regression/collated-files.pdf, pdf version})
 
-@manualDevelNotationSplit
-
-@manualDevelNotationBig
+@item
+@uref{../../input/regression/musicxml/collated-files.html, MusicXML tests}:
+This release's musicXML tests.
+(@uref{../../input/regression/musicxml/collated-files.pdf, pdf version})
 
-@manualDevelNotationPdf
+@item
+@uref{../../input/regression/abc2ly/collated-files.html, abc2ly tests}:
+This release's abc2ly tests.
+(@uref{../../input/regression/abc2ly/collated-files.pdf, pdf version})
 
 @item
-Usage:
+@uref{../../input/regression/lilypond-book/collated-files.html, lilypond-book tests}:
+This release's lilypond-book tests.
+(@uref{../../input/regression/lilypond-book/collated-files.pdf, pdf version})
+@end itemize
 
-@manualDevelUsageSplit
+@end ifclear
 
-@manualDevelUsageBig
+@ifset web_version
+@subsubheading Development version
 
-@manualDevelUsagePdf
+@itemize
+@item @regtestDevel (@regtestDevelPdf{})
 
-@item
-Snippets:
+@item @regtestDevelXml (@regtestDevelXmlPdf{})
 
-@manualDevelSnippetsSplit
+@item @regtestDevelAbc (@regtestDevelAbcPdf{})
 
-@manualDevelSnippetsBig
+@item @regtestDevelLilypondBook (@regtestDevelLilypondBookPdf{})
+@end itemize
 
-@manualDevelSnippetsPdf
+@subsubheading Stable version
 
+@itemize
+@item @regtestStable (@regtestStablePdf{})
 
-@c separate introduction, regular, infrequent manuals
-@smallspace
+@item @regtestStableXml (@regtestStableXmlPdf{})
 
-@item
-Web:
+@item @regtestStableAbc (@regtestStableAbcPdf{})
 
-@manualDevelWebSplit
+@item @regtestStableLilypondBook (@regtestStableLilypondBookPdf{})
+@end itemize
+@end ifset
 
-@manualDevelWebBig
 
-@manualDevelWebPdf
+@subsubheading All versions
 
-@item
-Changes:
+@itemize
+@item @uref{http://lilypond.org/test, Comparisons between regression tests}
 
-@manualDevelChangesSplit
+@item @uref{http://lilypond.org/download/binaries/test-output/,
+Archive of all regression tests}
 
-@manualDevelChangesBig
+@end itemize
 
-@manualDevelChangesPdf
+@divEnd
+@divEnd
 
-@item
-Extend:
 
-@manualDevelExtendingSplit
 
-@manualDevelExtendingBig
+@divClass{column-center-bottom}
+@subheading Manuals
 
-@manualDevelExtendingPdf
+@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
-Internals:
+@docLinkSplit{Learning,learning,@manualDevelLearningSplit}
+@tab
+@docLinkBig{Learning,learning,@manualDevelLearningBig}
+@tab
+@docLinkPdf{Learning,learning,@manualDevelLearningPdf}
 
-@manualDevelInternalsSplit
+@item
+@docLinkSplit{Glossary,music-glossary,@manualDevelGlossarySplit}
+@tab
+@docLinkBig{Glossary,music-glossary,@manualDevelGlossaryBig}
+@tab
+@docLinkPdf{Glossary,music-glossary,@manualDevelGlossaryPdf}
 
-@manualDevelInternalsBig
+@item
+@docLinkSplit{Essay,essay,@manualDevelEssaySplit}
+@tab
+@docLinkBig{Essay,essay,@manualDevelEssayBig}
+@tab
+@docLinkPdf{Essay,essay,@manualDevelEssayPdf}
 
-@manualDevelInternalsPdf
+@headitem Regular
 
-@end itemize
-@divEnd
-@divEnd
+@item
+@docLinkSplit{Notation,notation,@manualDevelNotationSplit}
+@tab
+@docLinkBig{Notation,notation,@manualDevelNotationBig}
+@tab
+@docLinkPdf{Notation,notation,@manualDevelNotationPdf}
 
+@item
+@docLinkSplit{Usage,usage,@manualDevelUsageSplit}
+@tab
+@docLinkBig{Usage,usage,@manualDevelUsageBig}
+@tab
+@docLinkPdf{Usage,usage,@manualDevelUsagePdf}
 
-@divClass{column-right-top}
-@subheading Contributor's Guide
+@item
+@docLinkSplit{Snippets,snippets,@manualDevelSnippetsSplit}
+@tab
+@docLinkBig{Snippets,snippets,@manualDevelSnippetsBig}
+@tab
+@docLinkPdf{Snippets,snippets,@manualDevelSnippetsPdf}
 
-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.
+@headitem Infrequent
 
-@warning{This manual is not intended to be read sequentially; new
-contributors should only read the sections which are relevant to
-them.  For more information about different jobs, see
-@ref{Help us}.}
+@item
+@docLinkSplit{Web,web,@manualDevelWebSplit}
+@tab
+@docLinkBig{Web,web,@manualDevelWebBig}
+@tab
+@docLinkPdf{Web,web,@manualDevelWebPdf}
 
-@docLinks{Contributor's Guide, contributor,
-  @rcontribnamed{Top,Contributor's Guide},
-  @manualDevelContributorSplit,
-  @manualDevelContributorBig, 500 kB,
-  @manualDevelContributorPdf, 2.8 MB}
+@item
+@docLinkSplit{Changes,changes,@manualDevelChangesSplit}
+@tab
+@docLinkBig{Changes,changes,@manualDevelChangesBig}
+@tab
+@docLinkPdf{Changes,changes,@manualDevelChangesPdf}
 
-@divEnd
+@item
+@docLinkSplit{Extending,extending,@manualDevelExtendingSplit}
+@tab
+@docLinkBig{Extending,extending,@manualDevelExtendingBig}
+@tab
+@docLinkPdf{Extending,extending,@manualDevelExtendingPdf}
 
+@item
+@docLinkSplit{Internals,internals,@manualDevelInternalsSplit}
+@tab
+@docLinkBig{Internals,internals,@manualDevelInternalsBig}
+@tab
+@docLinkPdf{Internals,internals,@manualDevelInternalsPdf}
 
-@divClass{column-right-top}
-@subheading Frogs: new contributors
+@ifset web_version
+@headitem Downloadable
 
-The Frogs are a collection of new contributors being mentored in
-how to @qq{eat} (fix) bugs and add new features to LilyPond.
-Programmers unfamiliar with LilyPond are encouraged to send
-patches to the Frogs first for initial discussion and
-encouragement.
+@item
+@doctarballDevel
+@end ifset
 
-Website and mailist: @uref{http://frogs.lilynet.net}
+@end multitable
 
 @divEnd
+@divEnd
 
-@divClass{column-right-bottom}
-@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})
 
-@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.
-
-@end itemize
-@divEnd
-@divEnd
 
 @node Authors
 @unnumberedsec Authors
 
-@help{Under construction; this is not an accurate list!}
-
-
 @divClass{column-left-top}
 @subheading Current Development Team
 
@@ -796,6 +892,10 @@ Comparisons between versions.
 
 @docCurrent
 
+@subsubheading Bug squad
+
+@bugsquadCurrent
+
 @subsubheading Support
 
 @supportCurrent
@@ -824,6 +924,11 @@ Comparisons between versions.
 
 @docPrevious
 
+@c    uncomment when we have any previous members -gp
+@c @subsubheading Bug squad
+
+@c @bugsquadCurrent
+
 @subsubheading Support
 
 @supportPrevious
@@ -841,153 +946,29 @@ Comparisons between versions.
 @unnumberedsec Publications
 
 @divClass{column-center-top}
-@subheading What we wrote
+@subheading What we wrote about LilyPond
 
 @divClass{keep-bullets}
-@itemize
-
-@item
-Han-Wen Nienhuys, @emph{LilyPond, Automated music formatting and
-the Art of Shipping}.  Forum Internacional Software Livre 2006
-(FISL7.0) (@uref{http://lilypond.org/web/images/FISL7-slides.pdf,
-PDF 1095k})
 
-@item
-Erik Sandberg, @emph{Separating input language and formatter in
-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})
-
-@item
-Han-Wen Nienhuys and Jan Nieuwenhuizen, @emph{LilyPond, a system
-for automated music engraving}.  Proceedings of the XIV Colloquium
-on Musical Informatics (XIV CIM 2003), Firenze, Italy, May 2003.
-(@uref{ http://lilypond.org/web/images/xivcim.pdf, PDF 95k})
-
-@end itemize
+@include we-wrote.itexi
 
 @divEnd
 @divEnd
 
-
 @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 in detail engraving
-capabilities of both pieces of software.  The second article is an
-instructive analysis of Rachmaninoff's Piano Prelude 6 engraving,
-including comparisons with a reference hand-engraved edition.
-
-@item
-June 2006
-
-@uref{http://distrowatch.com,DistroWatch} awards LilyPond and writes
-@uref{http://distrowatch.com/weekly.php?issue=20060605,writes}
-
-“Ladies and Gentleman, we are pleased to announce that, based on
-readers' requests, the DistroWatch May 2006 donation has been awarded to
-LilyPond (€190.00) and Lua (US$250.00).”
-
-@item
-December 2005
-
-@ignore
-we lost lj cover image here
-
-  <a href="@IMAGES@lj-cover140.png">
-    <img src="@IMAGES@lj-cover140-small.png" align="right" alt="linux journal cover">
-  </a>
-
-@uref{http://linuxjournal.com,Linux journal} cover
-@end ignore
-
-
-@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 a in-depth but hands-on
-feature article with crisp LilyPond graphics.  Author Kris Shaffer
-remarks “GNU Lilypond generates beautiful graphics that make
-commercial alternatives seem second-rate.”
-
-@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 `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.
-
-@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}.
-
-@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
-
-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.
+@divClass{keep-bullets}
 
-@end itemize
+@include others-did.itexi
 
 @divEnd
 @divEnd
 
+@contactUsAbout{academic papers}
+
 
 @node Old news
 @unnumberedsec Old news
@@ -995,5 +976,3 @@ issue CMS06.
 @include web/news-front.itexi
 
 @include web/news.itexi
-
-