More small changes

IntroTutorial-KickDrumSynthesis.adoc

@@ -40,14 +40,16 @@ I'm just going to place a simple 4/4 pattern. You can do anything you like, but
 
 image::screenshots/ardour-midi-4-4-pattern.png[]
 
-This tutorial uses note A4 as our starting note. You can press the `Y` key on your QWERTY keyboard to hear it.
+This tutorial uses note A4 as our starting note.
+You can press the `Y` key on your QWERTY keyboard to hear it.
+// TODO: Other keyboards? Edit > Preferences > MIDI > "Virtual Keyboard Layout:"
 
 ==== Loop your midi pattern
 Now we're going to tell Ardour to loop this specific region whenever we tell it to play. Right click on your midi area, select "play", and "loop region".
 
 image::screenshots/ardour-loop-region.png[]
 
-You should now here your pattern being played using the default Zyn-fusion synthesizer. Let's transform it into a kick drum.
+You should now hear your pattern being played using the default Zyn-fusion synthesizer. Let's transform it into a kick drum.
 
 ==== Launch Zyn-Fusion
 * Select your `Synth` track and then *double-click* on the ZynAddSubFX button (circled in red below)
@@ -61,7 +63,7 @@ image::screenshots/launch-ADDsynth.png[]
 
 .What Key am I in?
 NOTE: We use note `A4` as our starting point. You can press the `Y` key on your QWERTY keyboard to hear this note.
-// TODO: PEKI: QWERTY only?
+// TODO: QWERTY only? Another TODO on line #45.
 
 ==== Lower the octave
 By the the repetive beeping has probably started to bother anyone within listening distance, yourself included. Let's drop it a bit and get it closer to the sound we're looking for.
@@ -85,7 +87,7 @@ You don't need to worry about these terms if you don't already know them, we'll
 
 We're going to shorten the *Release* of the Global amplitude envelope, or in simpler terms, let's make the note "shorter".
 
-* Adjust `R.DT` to `63`. 
+* Adjust `R.DT` to `63`.
 ** What do you notice about how the sound has changed?
 ** Can you hear a new `clicking` sound?
 
@@ -109,7 +111,7 @@ It's getting closer! Let's add a little more depth to the sound by extending the
 
 image::screenshots/global-freq-env-attack.png[]
 
-It sounds more like a drum now but not quite the _deep_ sound we're looking for in a kick. 
+It sounds more like a drum now but not quite the _deep_ sound we're looking for in a kick.
 
 .Quiz Time
 NOTE: Knowing what you've learned so far, how you attempt to literally _drop the bass_ at this point?

Introduction.adoc

@@ -9,18 +9,19 @@ engines, 10+ filter options, lfos/envelopes for modulation, microtonal support,
 multi-parameter automation support, as well as many other features.
 Zyn can be run both as a standalone application as well as a VST/LV2/DSSI plugin
 within your favorite DAW.
+// TODO: The line below this comment is susceptible to change
 ZynAddSubFX can be controlled through multiple interfaces, though this manual
 will focus on the new and powerful Zyn-Fusion interface.
 
 === About the User Manual
 
 The Manual was divided into several sections:
 
-Introduction:: is the first part of the Manual, we're starting with a few simple tutorials to get the user hands-on with the synthesizer as fast as possible.
-Basic:: is the second part where we start to cover everything from top to bottom. If you're fairly new to Zyn-Fusion ,this part should provide you with a comprehensive, yet not overwhelming instruction.
-Advanced:: the third part, where we go into more detail and cover things that were skipped in the previous part. More advanced users should benefit from this part, adding depth to their understanding of the synthesizer. For newcomers, this part might be too confusing.
-Glossary:: this part is a glossary appendix with various terms indexed alphabetically
-Routing Diagrams:: the last part is a set are signal routing diagrams that should let you gain a deep understanding of the inner workings of the synthesizer.
+Introduction:: We're starting with a few simple tutorials to get the user hands-on with the synthesizer as fast as possible.
+Basic:: We start to cover everything from top to bottom. If you're fairly new to Zyn-Fusion ,this part should provide you with a comprehensive, yet not overwhelming instruction.
+Advanced:: We go into more detail and cover things that were skipped in the previous part. More advanced users should benefit from this part, adding depth to their understanding of the synthesizer. For newcomers, this part might be too confusing.
+Glossary:: A glossary appendix with various terms indexed alphabetically
+Routing Diagrams:: Signal routing diagrams that should let you gain a deep understanding of the inner workings of the synthesizer.
 
 === Quick start
 

README.md

@@ -7,12 +7,11 @@ This may or may not get merged into zynaddsubfx/zynaddsubfx's doc dir.
 ## Tools of the trade
 
 The Manual is in [`AsciiDoc` format](https://powerman.name/doc/asciidoc).
-
 For a powerful editor with live preview for Linux, check [`AsciidocFX`](https://github.com/asciidocfx/AsciidocFX).
-
 If you need a different tool, look [here](https://asciidoctor.org/docs/editing-asciidoc-with-live-preview/).
 
 The repo includes a [`Makefile`](./Makefile), which compiles the manual and stores it in the, appropriately named, `Manual.html`.
+The `Makefile` builds using [`Asciidoctor`](https://asciidoctor.org/), which can be changed in the file.
 
 ## Files
 

UserInterface.adoc

@@ -20,20 +20,26 @@ Panic button::
     When getting started you'll want to be familiar with the panic button as
     it will instantly silence the audio produced by Zyn, no matter what state
     the synth is in. It's a safety device in case the sounds go out of control.
+
 Master VU meter::
     This meter will display the current audio output levels. It can be useful for a few things:
     * It'll let you decide on choosing an optimal sound level for your patch.
     * It might be helpful to find out which instance of Zyn-Fusion is currently making sounds, if you're working with a few of them at once.
     * It'll help you make sure your MIDI keyboard is connected properly.
+
 Fine indicator::
     This indicator shows when parameters are being finely adjusted. Fine adjust
     is trigged by holding *SHIFT* and it can be toggled by clicking on the
     indicator.
+
 Learn indicator::
     This indicator shows when automation learning is in progress.
+
 Information Tray::
     The information tray will show tooltips about Zyn's parameters, current
-    parameter values, as well as other status information. image:imgs/info-tray.png[]
+    parameter values, as well as other status information. Image below.
+
+image:imgs/info-tray.png[]
 
 ////
 .Screenshot todo
@@ -82,26 +88,24 @@ make it not behave that way in the future.
 
 === Navigation Panel
 
-The left side of the screen can be used to change what view the content panel is
-actively presenting.
-The side panel is used to navigate between different parts of the user
-interface.
+The left side of the screen can be used to change what view the content panel is actively presenting.
+The side panel is used to navigate between different parts of the user interface.
 From here you can change the view in the main panel to:
 
 * Part settings
-* Part Grid - the active part id
+* Part Grid - the active part ID
 * Browser
 * Mixer
 * Kits
-* Kit Grid - the active kit id
+* Kit Grid - the active kit ID
 * Macro Learn
 * Effects
 * Add synth
-* Add synth Voice Grid - the active voice id
+* Add synth Voice Grid - the active voice ID
 * Sub synth
 * Pad synth
 
-For all of the grid selectors you can change the active id with the left mouse
+For all of the grid selectors you can change the active ID with the left mouse
 button or you can enable/disable the selected ID via the middle mouse button.
 
 === Main Panel