- <h2>MIDI Handling Frameworks</h2>
-<h4>CoreMIDI</h4>
-<p> CoreMIDI is the standard MIDI framework to comunicate with MIDI hardware on OSX systems. It provides drivers and libraries needed by MIDI clients. These ports do not show up in qjackctl</p>
+
+<h2>What Can Ardour Do With MIDI?</h2>
+<p>
+ <dfn><abbr title="Musical Instrument Digital Interface">MIDI</abbr></dfn>
+ is a way to describe music data and to control music hardware and
+ software. Ardour can import and record MIDI data, and perform a
+ variety of editing operations on it. Furthermore, MIDI can be used to
+ control various functions of Ardour.
+</p>
+<p class="note">
+ Ardour does not include a <dfn>synthesis engine</dfn> to produce audio
+ from MIDI data, but relies on plugins or external hard- and software
+ for the task. This can be a stumbling block for first time users who
+ expect MIDI input to result in audio output by default.<br />
+ Please see the section on working with plug-ins for more information on
+ turning MIDI data into audio output.</p>
+
+<h2>MIDI Handling Frameworks</h2>
+<p>
+ Ardour supports various ways of sending and receiving MIDI data:
+</p>
+
+<h3>CoreMIDI</h3>
+<p>
+ <dfn>CoreMIDI</dfn> is the standard MIDI framework on OSX systems.
+ It provides drivers for MIDI hardware and libraries needed by MIDI
+ software clients.
+</p>
+