Help:Contributing: Difference between revisions

(2 intermediate revisions by one other user not shown)

Line 1:

You can edit without an account, but this is encouraged if you do more than a handful of edits so that other editors can recognize you and discuss with you in case of need.

To create a new page, type the title in the search box, then click on the red link. A simple page can be structured as follows:

Line 4:

Line 6:

Some explanatory text.

{ c'^"a note!" }

</lilypond>

Line 13:

Line 15:

:: Some explanatory text.

::

:: <lilypond version="2.24.0">

:: <lilypond version="2.24">

{ c'^"a note!" }

</lilypond>

Line 20:

Line 22:

First, describe what the snippet does and how to use it. Use [https://www.mediawiki.org/wiki/Help:Formatting wikitext markup] like <code><nowiki>''italic''</nowiki></code> for ''italic'', <code><nowiki>'''bold'''</nowiki></code> for '''bold''' and <code><nowiki><code>\command</code></nowiki></code> for <code>\command</code>.

The LilyPond snippet goes between <code><nowiki><lilypond version="..."></nowiki></code> and <code><nowiki></lilypond></nowiki></code>. The <code>version</code> parameter is the LilyPond version used to compile the snippet. A <code>\version</code> statement with this version will also be added automatically, so don't repeat it in the snippet code. ~~You can use any LilyPond version (it will be automatically downloaded if needed)~~, ~~but~~ you should ~~generally use~~ the latest stable LilyPond ~~version~~, ~~unless~~ your ~~snippet~~ specifically requires a newer development version.

The LilyPond snippet goes between <code><nowiki><lilypond version="..."></nowiki></code> and <code><nowiki></lilypond></nowiki></code>.

The <code>version</code> parameter is the LilyPond version used to compile the snippet. A <code>\version</code> statement with this version will also be added automatically, so don't repeat it in the snippet code. In almost all cases, you should put the major and minor number of the latest stable release series of LilyPond, e.g., 2.24. This will automatically select the latest micro release in that series, e.g., 2.24.4. However, in case your example specifically requires a newer development version, you can put that specific version here, e.g., 2.25.27 (it will be automatically downloaded on the wiki if needed).

If you need to demonstrate page layout features, use the <code>full</code> keyword to prevent cropping, like this: <code><nowiki><lilypond version="..." full></nowiki></code>.

'''Please be careful while editing snippets that are tagged with the category “Included in the official documentation”!''' There are special requirements so that they can be used seamlessly in LilyPond's documentation. See [[:Category:Included in the official documentation]] for more information.

@@ Line 1: / Line 1: @@
+You can edit without an account, but this is encouraged if you do more than a handful of edits so that other editors can recognize you and discuss with you in case of need.
 To create a new page, type the title in the search box, then click on the red link. A simple page can be structured as follows:
@@ Line 4: / Line 6: @@
 Some explanatory text.
-<lilypond version="2.24.0">
+<lilypond version="2.24">
 { c'^"a note!" }
 </lilypond>
@@ Line 13: / Line 15: @@
 :: Some explanatory text.
 ::
-:: <lilypond version="2.24.0">
+:: <lilypond version="2.24">
 { c'^"a note!" }
 </lilypond>
@@ Line 20: / Line 22: @@
 First, describe what the snippet does and how to use it. Use [https://www.mediawiki.org/wiki/Help:Formatting wikitext markup] like <code><nowiki>''italic''</nowiki></code> for ''italic'', <code><nowiki>'''bold'''</nowiki></code> for '''bold''' and <code><nowiki><code>\command</code></nowiki></code> for <code>\command</code>.
-The LilyPond snippet goes between <code><nowiki><lilypond version="..."></nowiki></code> and <code><nowiki></lilypond></nowiki></code>. The <code>version</code> parameter is the LilyPond version used to compile the snippet. A <code>\version</code> statement with this version will also be added automatically, so don't repeat it in the snippet code. You can use any LilyPond version (it will be automatically downloaded if needed), but you should generally use the latest stable LilyPond version, unless your snippet specifically requires a newer development version.
+The LilyPond snippet goes between <code><nowiki><lilypond version="..."></nowiki></code> and <code><nowiki></lilypond></nowiki></code>.
+The <code>version</code> parameter is the LilyPond version used to compile the snippet. A <code>\version</code> statement with this version will also be added automatically, so don't repeat it in the snippet code. In almost all cases, you should put the major and minor number of the latest stable release series of LilyPond, e.g., 2.24. This will automatically select the latest micro release in that series, e.g., 2.24.4. However, in case your example specifically requires a newer development version, you can put that specific version here, e.g., 2.25.27 (it will be automatically downloaded on the wiki if needed).
 If you need to demonstrate page layout features, use the <code>full</code> keyword to prevent cropping, like this: <code><nowiki><lilypond version="..." full></nowiki></code>.
+'''Please be careful while editing snippets that are tagged with the category “Included in the official documentation”!'''  There are special requirements so that they can be used seamlessly in LilyPond's documentation.  See [[:Category:Included in the official documentation]] for more information.