Cards and heading normaization

Author: prokoudine

content/_index.md

@@ -22,14 +22,10 @@ sidebar:
 ## Let's get started!
 
 {{< cards >}}
-  {{< card link="basics/" title="Basics" subtitle="What is audio and MIDI?" icon="book-open" >}}
-  {{< card link="getting-started/" title="Getting started" subtitle="Understanding the user interface" icon="fast-forward" >}}
-  {{< card link="recording/" title="Recording" subtitle="How to record audio and MIDI with Ardour" icon="microphone" >}}
-  {{< card link="editing-sessions/" title="Editing sessions" subtitle="How to edit sessions with Ardour" icon="scissors" >}}
-  {{< card link="performing-live/" title="Performing live" subtitle="How to use the matrix cue sequencer" icon="music-note" >}}
-  {{< card link="mixing-sessions/" title="Mixing sessions" subtitle="How to setup routing and use plugins" icon="filter" >}}
-  {{< card link="exporting-sessions/" title="Exporting sessions" subtitle="How to export to stems and single files" icon="share" >}}
-  {{< card link="saving-sessions/" title="Saving sessions" subtitle="How to save session snapshots and templates" icon="save" >}}
+  {{< card link="getting-started/" title="Learn user interface basics" image="en/ardour8-ui-basics-thumb.webp" >}}
+  {{< card link="recording/" title="Record your first audio and MIDI tracks" image="en/ardour8-edit-sessions-thumb.webp" >}}
+  {{< card link="editing-sessions/" title="Arrange tracks and edit clips" image="en/ardour8-edit-sessions-thumb.webp" >}}
+  {{< card link="mixing-sessions/" title="Mix tracks with plugins and automation" image="en/ardour8-mix-sessions-thumb.webp" >}}
 {{< /cards >}}
 
 ## User support

content/basics/midi/index.md

@@ -22,13 +22,13 @@ MIDI keyboards and grid controllers like Launchpad commonly send MIDI messages t
 
 Uploading a patch from a desktop editor to a guitar multi-FX processor typically involves sending a SysEx MIDI message.
 
-## How MIDI Works
+## How MIDI works
 
 The most important thing to understand is that MIDI keyboards do not make any audio whatsoever. What they do is send instructions that hardware or software can interpret to make sound or change the sound or do something else entirely.
 
 Most of the time, you will deal with MIDI by recording yourself playing on a MIDI keyboard.
 
-Consider this keyboard:
+Here is a typical MIDI keyboard with a minimal set of controls:
 
 ![Minilab 3](images/midi-keyboard-top.png)
 
@@ -52,7 +52,7 @@ Just like encoders, faders send CC messages.
 
 5. **Pitch bend** and **Modulation** controls. 
 
-## How MIDI Messages Are Sent
+## How MIDI messages are sent
 
 Let's take a look at the back panel of the same keyboard:
 
@@ -72,11 +72,11 @@ If MIDI keyboards don't make sounds, who does?
 
 Unless you specify otherwise, Ardour will create every new MIDI track with a virtual synthesizer automatically added. This mean you will always hear the MIDI track processing instructions from either input (like your MIDI keyboard) or the MIDI track and playing sound.
 
-## What Are MIDI Channels?
+## What are MIDI channels?
 
 One last concept you need to learn here is MIDI channels. Consider this setup. You have a MIDI keyboard connected to a hardware synthesizer. The synthesizer can store presets, or patches, each producing a unique sound. As a multi-voice synthesizer, it can play different sounds at the same time, e.g. a bass and a lead part simultaneously. To do so, it expects instructions for each patch coming separately, through independent pathways called MIDI channels.
 
-## Further Reading
+## Further reading
 
 If you want to know how to use MIDI gear efficiently with Ardour, please read the [MIDI devices](/using-your-gear/midi-devices) chapter.
 

content/getting-started/overview-of-the-interface/_index.md

@@ -42,7 +42,7 @@ For instance, you'll find the contents of the _Region_ menu in the right-click
 menu for a selected region (a clip that you can see on the timeline, see further
 pages of the tutorial).
 
-## Info Panel
+## Info panel
 
 This panel displays useful information about the currently opened project
 (sampling rate, latency, DSP load) as well as how many estimated minutes of
@@ -103,7 +103,7 @@ doesn't have those rulers.
 Please check the Ardour manual for more information on the
 [mini-timeline](https://manual.ardour.org/ardours-interface/mini-timeline/).
 
-## Switching Between Windows
+## Switching between windows
 
 To the right of the global toolbar, right after the _Navigation Timeline_ and
 the master bus output meter, you'll find a convenient widget to switch between
@@ -123,5 +123,10 @@ another one will take you to the _Editor_ window.
 
 The next sections will explain basics of main Ardour's windows:
 
-[Editor](editor-window) | [Mixer](mixer-window) | [Recorder](recorder-window) |
-[Cue](cue-window)
+{{< cards >}}
+  {{< card link="editor-window" title="Editor" image="en/ardour8-editor-window-thumb.webp">}}
+  {{< card link="mixer-window" title="Mixer" image="en/ardour8-mixer-window-thumb.webp" >}}
+  {{< card link="recorder-window" title="Recorder" image="en/ardour8-recorder-window-thumb.webp" >}}
+  {{< card link="cue-window" title="Cue" image="en/ardour8-cue-window-thumb.webp" >}}
+{{< /cards >}}
+

content/using-your-gear/_index.md

@@ -6,7 +6,7 @@ cascade:
   type: docs
 ---
 
-Before you get to record audio or MIDI, let's learn how to set your studio up for use with Ardour.
+Before you get to record audio or MIDI, let's learn how to set your studio up for use with Ardour: audio interfaces, MIDI keyboards and controllers, and control surfaces.
 
 Contents: