-<h2>Adding new notes</h2>
-<p>
- In general, most MIDI editing will probably be done with the mouse in object
- mode. This allows to select notes, copy, move or delete them and alter their
- properties (see below). But at some point, <em>adding</em> notes to a MIDI
- region using the mouse will mean dragging with the mouse. Since this would
- normally be a selection operation if the mouse is in object mode, there needs
- to be some way to tell Ardour that the user is trying to <dfn>draw</dfn> new
- notes within a MIDI region. Ardour provides two ways do this. One is to leave
- the mouse in object mode and <kbd class="mouse mod1">Left</kbd>-drag. The
- other, useful to enter a lot of notes for a while, is to switch the mouse into
- <kbd class="menu">Draw Notes</kbd> mode, which will now interpret any drags
- and clicks as requests to add a new note. For obvious reasons, Draw Notes mode
- can not be used while using region-level editing.
-</p>
-
-<p>So, to summarize:</p>
+<p>
+ MIDI notes can be added a few different way in Ardour:
+<p>
+
+<h2 id="add-new-notes-using-the-mouse">Using the mouse</h2>
+
+<p>
+ Drawing notes with the mouse requires that a MIDI track <a
+ href="@@create-midi-tracks">exists</a>, and a blank MIDI region has
+ been <a href="@@create-midi-regions">created</a> in this track.
+</p>
+<p>
+ In either <em>Draw</em> or <em>Internal Edit</em> <a
+ href="@@toolbox">Mode</a> new notes can be added with a click or
+ drag: a mouse <em>click</em> creates a note at the pointer location
+ (or the nearest grid anchor if grid is enabled), and its duration is
+ one <a href="@@grid-controls">Grid unit</a>. A mouse <em>drag</em>
+ creates the note like a click does, but allows continuously setting
+ the duration of the note until the mouse button is released.
+</p>
+
+<p>
+ The toolbar available in the <dfn>Draw</dfn> mode helps drawing notes
+ of exact length, in a certain MIDI channel, with predefined velocity:
+</p>
+
+<figure>
+<img style="width:75%" src="/images/midi-draw-toolbar.png" alt="MIDI draw toolbar">
+<figcaption>MIDI draw toolbar</figcaption>
+</figure>
+
+<p>
+ While the <dfn>Velocity</dfn> drop-down list only displays presets,
+ you can hover it and use mouse wheel scrolling to increment the current
+ value by 1. Scrolling above the other two drop-down lists will cycle
+ through the presets.
+</p>
+
+<p>
+ The <dfn>Auto</dfn> option in three drop-down lists works differently
+ in all three cases:
+</p>
+