From 4a898e4a87ba100ac4c6dde0fceecc718cca8060 Mon Sep 17 00:00:00 2001
From: Ed Ward <edwsaintesprit@hotmail.com>
Date: Mon, 16 Jan 2017 19:38:18 +0100
Subject: [PATCH] Documenting the Window and Help menus

---
 .../01_main-menu/07_Window-menu.html          | 64 +++++++++----------
 .../01_main-menu/08_Help-menu.html            | 25 ++++----
 2 files changed, 44 insertions(+), 45 deletions(-)

diff --git a/_manual/05_ardours-interface/01_main-menu/07_Window-menu.html b/_manual/05_ardours-interface/01_main-menu/07_Window-menu.html
index 7516a16..a416d1d 100644
--- a/_manual/05_ardours-interface/01_main-menu/07_Window-menu.html
+++ b/_manual/05_ardours-interface/01_main-menu/07_Window-menu.html
@@ -2,39 +2,35 @@
 title: The Window Menu
 ---
 
-<p class="fixme">Describe the items</p>
+<p>
+	The <dfn>Window</dfn> menu deals with the layout of the different windows, and their visibility.
+</p>
 
+<dl>
+	<dt>[] Audio/MIDI Setup</dt><dd>Shows the <a href="/working-with-sessions/new-session-dialog/"><kbd class="menu">Audio/MIDI Setup</kbd> window</a>, where the sound system configuration can be modified</dd>
 
-Window
-	[] Audio/MIDI Setup
-	---
-	Editor
-		Show
-		Hide
-		Attach
-		Detach
-	Mixer
-		Show
-		Hide
-		Attach
-		Detach
-	Preferences
-		Show
-		Hide
-		Attach
-		Detach
-	Meterbridge
-	Scripting
-	---
-	[] Tracks and Busses
-	[] Locations
-	[] Binding Editor
-	[] Bundle Manager
-	[] Big Clock
-	---
-	[] Video Monitor
-	---
-	Midi Tracer
-	[] Audio Connections
-	[] MIDI Connections
-	[] Log
+	<dt>Editor</dt>
+		<dt class="sub1">Show</dt><dd>Switches to the Editor view</dd>
+		<dt class="sub1">Hide</dt><dd>Hides the Editor, hence showing the Mixer when the windows are attached</dd>
+		<dt class="sub1">Attach</dt><dd>If the Editor window is detached, separated from the main window, attach it back</dd>
+		<dt class="sub1">Detach</dt><dd>If the Editor is attached to the main window, fetach it (makes the Editor a separated window, usefull for multi-monitor setup)</dd>
+	<dt>Mixer</dt>
+		<dt class="sub1">Show/Hide/Attach/Detach</dt><dd>Same as for the Editor, for the <em>Mixer</em> window</dd>
+	<dt>Preferences</dt><dd></dd>
+		<dt class="sub1">Show/Hide/Attach/Detach</dt><dd>Same as for the Editor, for the <em>Preferences</em> window</dd>
+	<dt>Meterbridge</dt><dd>Shows the <a href="/meters/"><kbd class="menu">Meterbridge</kbd> window</a>, that displays all the tracks' meter at once and their recording status, and is very handy for multitrack recording</dd>
+	<dt>Scripting</dt><dd>Opens the <a href="/lua-scripting/"><kbd class="menu">Lua Scripting</kbd> window</a>, allowing to edit and run Lua scripts</dd>
+
+	<dt>[] Tracks and Busses</dt><dd>Opens the <kbd class="menu">Tracks and Busses</kbd> window, which is a shortcut to many tracks/busses operations (routing, effects, ...)</dd>
+	<dt>[] Locations</dt><dd><dd>Opens the <a href="/ardours-interface/the-editor/the-editor_s-lists/ranges-and-marks-list/"><kbd class="menu">Ranges and Marks</kbd> window</a>, a single point of control for all range and location markers</dd>
+	<dt>[] Binding Editor</dt><dd>Opens the <a href="/default-keyboard-bindings/"><kbd class="menu">Key Bindings</kbd> window</a>, which allows for easy creation or modification of any keyboard shortcut</dd>
+	<dt>[] Bundle Manager</dt><dd>Opens the <kbd class="menu">Bundle Manager</kbd> window, allowing to create and manage <em>Bundles</em>, which are a way to simplify connection management, by defining groups of ports</dd>
+	<dt>[] Big Clock</dt><dd>Opens the <a href="/ardours-interface/transport-bar-and-times/times/">Main Clock</a> as its own separate (and huge) window, which is helpfull when recording</dd>
+
+	<dt>[] Video Monitor</dt><dd>If a <a href="/video-timeline/">video</a> has been imported in the session, opens a video window (namely, <em>Xjadeo</em>), synced to the timeline</dd>
+
+	<dt>Midi Tracer</dt><dd>Opens the <kbd class="menu">MIDI Tracer</kbd> window, allowing to follow each and every MIDI message entering or leaving Ardour</dd>
+	<dt>[] Audio Connections</dt><dd>Opens the <a href="/signal-routing/Patchbay/"><kbd class="menu">Audio Connection Manager</kbd> window</a>, a way to make connections to, from and within Ardour's mixer</dd>
+	<dt>[] MIDI Connections</dt><dd>Same as above, for the MIDI connections</dd>
+	<dt>[] Log</dt><dd>Shows the <kbd class="menu">Log</kbd> window, where Ardour lists usefull information, warnings and errors</dd>
+</dl>
diff --git a/_manual/05_ardours-interface/01_main-menu/08_Help-menu.html b/_manual/05_ardours-interface/01_main-menu/08_Help-menu.html
index f81248f..c8992c0 100644
--- a/_manual/05_ardours-interface/01_main-menu/08_Help-menu.html
+++ b/_manual/05_ardours-interface/01_main-menu/08_Help-menu.html
@@ -2,15 +2,18 @@
 title: The Help Menu
 ---
 
-<p class="fixme">Describe the items</p>
+<p>
+	The <dfn>Help</dfn> Menu gives acces to usefull information about Ardour.
+</p>
 
-Help
-	[] About
-	Chat
-	Manual
-	Reference
-	User Forums
-	How to Report a Bug
-	Report a Bug
-	Ardour Website
-	Ardour Development
+<dl>
+	<dt>[] About</dt><dd>Shows the <kbd class="menu">About Ardour</kbd> window, which contains information about the version, config, authors,and license of Ardour</dd>
+	<dt>Chat</dt><dd>This is a shortcut to the webchat version of the Freenode IRC channel of Ardour, where the developpers meet, and questions can be asked if the Manual is not enough</dd>
+	<dt>Manual</dt><dd>Link to a FLOSSManual guide to Ardour</dd>
+	<dt>Reference</dt><dd>Link to this manual, hosted on ardour.org</dd>
+	<dt>User Forums</dt><dd>Link to ardour.org's user forum</dd>
+	<dt>How to Report a Bug</dt><dd>Link to an helping page about reporting bugs</dd>
+	<dt>Report a Bug</dt><dd>Link to Ardour's Mantis bugtracker</dd>
+	<dt>Ardour Website</dt><dd>Link to Ardour's main and official website</dd>
+	<dt>Ardour Development</dt><dd>Link to the developpers' part of the official website</dd>
+</dl>
-- 
2.37.2