1 @c -*- coding: us-ascii; mode: texinfo; -*-
6 * Introduction to LSR::
13 @node Introduction to LSR
14 @section Introduction to LSR
17 @uref{http://lsr.dsi.unimi.it/, LilyPond Snippet Repository (LSR)}
18 is a collection of lilypond examples. A subset of these examples
19 are automatically imported into the documentation, making it easy
20 for users to contribute to the docs without learning git and
25 @section Adding snippets
27 When you create (or find!) a nice snippet, please add it to LSR.
28 Go to @uref{http://lsr.dsi.unimi.it/, LSR} and log in (if you
29 haven't already, create an account). Follow the instructions on
32 If you think the snippet is particularly informative and you think
33 it should be included in the documentation, tag it with "docs" and
34 one or more other categories.
36 Please make sure that the lilypond code follows the guidelines in
37 @ref{LilyPond formatting}.
40 @node Approving snippets
41 @section Approving snippets
43 The main task of LSR editors are approving snippets. Log in to
44 @uref{http://lsr.dsi.unimi.it/, LSR} and find a list of unapproved
46 FIXME DOING SOMETHING.
53 Does the snippet make sense and does what the author claims that
54 it does? If you think the snippet is particularly helpful, add
55 the "docs" tag and at least one other tag.
58 If the snippet is tagged with "docs", check to see if it matches
59 our guidelines for @ref{LilyPond formatting}.
62 If the snippet uses scheme, check that everything looks good and
63 there are no security risks.
65 @warning{Somebody could sneak a @code{#'(system "rm -rf /")}
66 command into our source tree if you do not do this! Take this
67 step @strong{VERY SERIOUSLY}.}
75 FIXME: Neil, please check that this is up-to-date.
80 Download the latest tarball from
81 @uref{http://lsr.dsi.unimi.it/download/}. You want a file called
82 @file{lsr-snippets-docs-DATE.tar.gz}.
85 From the top source directory, run:
88 scripts/auxiliar/makelsr.py
92 Follow the instructions on the console to manually check for
95 @warning{Somebody could sneak a @code{#'(system "rm -rf /")}
96 command into our source tree if you do not do this! Take this
97 step @strong{VERY SERIOUSLY}.}
100 Do a git add / commit / push.