Further doc improvements

until Playtime track area

doc/helgobox/modules/ROOT/pages/app/user-interface/navigation-bar.adoc

@@ -13,10 +13,6 @@ include::partial$generated/elements/navbar/playtime.adoc[]
 
 include::partial$generated/elements/navbar/enable-disable-global-control.adoc[]
 
-If enabled, all connected controllers that you have equipped will load their corresponding main preset.
-You can configure controllers using the settings button in the window title bar.
-
-If disabled, global controllers will be ignored in this instance.
-You still have the freedom to create a custom control experience using ReaLearn.
+See xref:realearn::further-concepts/instance.adoc#auto-units[].
 
 include::partial$generated/elements/navbar/show-helgobox-plugin.adoc[]

doc/helgobox/modules/ROOT/pages/app/user-interface/settings-dialog.adoc

@@ -4,7 +4,6 @@ The dialog allows you to adjust the majority of global settings for Helgobox and
 You can open it by pressing the xref:app/user-interface/title-bar.adoc#title-bar-settings[
 image:generated/screenshots/elements/title-bar/settings.png[]] button in the xref:app/user-interface/title-bar.adoc[].
 
-
 image::generated/screenshots/main/settings.png[]
 
 For a description of the product-specific settings, see:
@@ -15,22 +14,38 @@ For a description of the product-specific settings, see:
 == Appearance
 
 include::partial$generated/elements/settings/overall-size.adoc[]
+
 include::partial$generated/elements/settings/roundness.adoc[]
+
+.For Playtime users
+TIP: If you want slot cells with rounded corners, play with the xref:playtime::user-interface/settings-dialog.adoc#settings-cell-color-position[] setting!
+
 include::partial$generated/elements/settings/prefer-tidy-appearance.adoc[]
+
 include::partial$generated/elements/settings/display-development-status-hints.adoc[]
+
 include::partial$generated/elements/settings/display-tooltip-if-help-panel-hidden.adoc[]
+
 include::partial$generated/elements/settings/display-license-info.adoc[]
+
 include::partial$generated/elements/settings/prefer-native-popup-menus.adoc[]
+
 include::partial$generated/elements/settings/theme-mode.adoc[]
+
 include::partial$generated/elements/settings/use-context-coloring.adoc[]
+
 include::partial$generated/elements/settings/use-host-colors.adoc[]
+
 include::partial$generated/elements/settings/contrast.adoc[]
+
 include::partial$generated/elements/settings/custom-color-rendering.adoc[]
+
 include::partial$generated/elements/settings/color-scheme.adoc[]
 
 == Title bar
 
 include::partial$generated/elements/settings/dim-opacity.adoc[]
 
 == Shortcuts
-// TODO Escape stuff
+
+include::partial$generated/elements/settings/hide-window-when-escape-pressed.adoc[]

doc/helgobox/modules/ROOT/pages/configuration-files.adoc

@@ -19,7 +19,9 @@ Helgobox itself maintains the following files:
 
 `licensing.json`:: Contains license keys
 
-`Helgoboss/App`:: Contains the uncompressed App, if installed
+`Helgoboss/App/bin`:: Contains the uncompressed xref:app.adoc[], if installed
+
+`Helgoboss/App/etc/settings.json`:: Contains the global settings for Helgobox and all of its contained products
 
 `Helgoboss/Pot/previews`:: Directory which contains previews recorded by xref:products.adoc#pot-browser[Pot Browser]
 

doc/helgobox/modules/ROOT/partials/generated/elements/area/nav-bar-0.adoc

@@ -4,3 +4,4 @@
 image:generated/screenshots/elements/area/nav-bar-0.png[Navigation bar, role="related thumb right"]
 
 null
+

doc/helgobox/modules/ROOT/partials/generated/elements/area/window-title-bar-0.adoc

@@ -4,3 +4,4 @@
 image:generated/screenshots/elements/area/window-title-bar-0.png[Title bar, role="related thumb right"]
 
 null
+

doc/helgobox/modules/ROOT/partials/generated/elements/navbar/enable-disable-global-control.adoc

@@ -4,3 +4,4 @@
 image:generated/screenshots/elements/navbar/enable-disable-global-control.png[Enable/disable global control, role="related thumb right"]
 
 Enables or disables the usage of global controllers for this Helgobox instance.
+

doc/helgobox/modules/ROOT/partials/generated/elements/navbar/home.adoc

@@ -4,3 +4,4 @@
 image:generated/screenshots/elements/navbar/home.png[Home, role="related thumb right"]
 
 Shows the Helgobox welcome page.
+

doc/helgobox/modules/ROOT/partials/generated/elements/navbar/playtime.adoc

@@ -4,3 +4,4 @@
 image:generated/screenshots/elements/navbar/playtime.png[Playtime, role="related thumb right"]
 
 Shows the Playtime Matrix associated with this Helgobox instance.
+

doc/helgobox/modules/ROOT/partials/generated/elements/navbar/projection.adoc

@@ -4,3 +4,4 @@
 image:generated/screenshots/elements/navbar/projection.png[ReaLearn Projection, role="related thumb right"]
 
 Shows the ReaLearn Projection page for this Helgobox instance.
+

doc/helgobox/modules/ROOT/partials/generated/elements/navbar/show-helgobox-plugin.adoc

@@ -4,3 +4,4 @@
 image:generated/screenshots/elements/navbar/show-helgobox-plugin.png[Show Helgobox plug-in, role="related thumb right"]
 
 Opens the Helgobox plug-in which is controlled by this app.
+

doc/helgobox/modules/ROOT/partials/generated/elements/settings/color-scheme.adoc

@@ -1,6 +1,7 @@
 [#settings-color-scheme]
 === Color scheme
 
-image:generated/screenshots/elements/settings/color-scheme.png[Color scheme, role="related thumb right"]
+image::generated/screenshots/elements/settings/color-scheme.png[Color scheme]
 
 Choose the prominent color for the user interface.
+

doc/helgobox/modules/ROOT/partials/generated/elements/settings/contrast.adoc

@@ -4,3 +4,4 @@
 image::generated/screenshots/elements/settings/contrast.png[Contrast]
 
 Choose between multiple color variations that influence the perceived contrast of the app's appearance.
+

doc/helgobox/modules/ROOT/partials/generated/elements/settings/custom-color-rendering.adoc

@@ -3,4 +3,5 @@
 
 image::generated/screenshots/elements/settings/custom-color-rendering.png[Custom color rendering]
 
-Determines how user-defined colors (e.g. for tracks and clips) will be rendered.
+Choose how to render user-defined colors, such as for tracks and clips.
+

doc/helgobox/modules/ROOT/partials/generated/elements/settings/dim-opacity.adoc

@@ -3,4 +3,5 @@
 
 image:generated/screenshots/elements/settings/dim-opacity.png[Dim opacity, role="related thumb right"]
 
-Determines how much to dim the Helgobox app window when pressing the dim button.
+Adjust how much to dim the Helgobox app window when pressing the dim button.
+

doc/helgobox/modules/ROOT/partials/generated/elements/settings/display-development-status-hints.adoc

@@ -4,3 +4,4 @@
 image::generated/screenshots/elements/settings/display-development-status-hints.png[Display development status hints]
 
 If enabled, the inspector will display even settings that are not available yet and it will show small annotations about the development state of a feature.
+

doc/helgobox/modules/ROOT/partials/generated/elements/settings/display-license-info.adoc

@@ -3,4 +3,5 @@
 
 image::generated/screenshots/elements/settings/display-license-info.png[Display license info]
 
-If enabled, the licensee name will be displayed in the window title bar (only when using a commercial component such as Playtime).
+If enabled, the licensee name will be displayed in the window title bar. This only affects commercial Helgobox products, such as Playtime.
+

doc/helgobox/modules/ROOT/partials/generated/elements/settings/display-tooltip-if-help-panel-hidden.adoc

@@ -4,3 +4,4 @@
 image::generated/screenshots/elements/settings/display-tooltip-if-help-panel-hidden.png[Display tooltip if help panel hidden]
 
 If enabled and the help panel in the bottom right corner is not visible, a tooltip will be showed instead.
+

doc/helgobox/modules/ROOT/partials/generated/elements/settings/hide-window-when-escape-pressed.adoc

@@ -0,0 +1,9 @@
+[#settings-hide-window-when-escape-pressed]
+=== Hide window when escape pressed
+
+image::generated/screenshots/elements/settings/hide-window-when-escape-pressed.png[Hide window when escape pressed]
+
+If enabled, pressing escape if no dialog is open will hide the window.
+
+This will only have an effect when running embedded within REAPER.
+

doc/helgobox/modules/ROOT/partials/generated/elements/settings/overall-size.adoc

@@ -3,4 +3,5 @@
 
 image::generated/screenshots/elements/settings/overall-size.png[Overall size]
 
-Allows you to adjust the overall size of the user interface, including the font size.
+Adjust the overall size of the user interface, including the font size.
+

doc/helgobox/modules/ROOT/partials/generated/elements/settings/prefer-native-popup-menus.adoc

@@ -4,3 +4,9 @@
 image::generated/screenshots/elements/settings/prefer-native-popup-menus.png[Prefer native popup menus (experimental)]
 
 If enabled, dropdown and right-click menus will be rendered using your system's native user interface component.
+[NOTE]
+.Development status: Feedback wanted!
+====
+This doesn't work particular well at the moment. On Windows, it has caused crashes in the past.
+====      
+

doc/helgobox/modules/ROOT/partials/generated/elements/settings/prefer-tidy-appearance.adoc

@@ -3,6 +3,7 @@
 
 image::generated/screenshots/elements/settings/prefer-tidy-appearance.png[Prefer tidy appearance]
 
-If enabled, the inspector will show dropdown menus even if if they present just a handful of options. This looks more tidy but you will need 2 mouse clicks to choose an option.
+If enabled, the inspector will show dropdown menus even if if they present just a handful of options. This looks more tidy but you will need two mouse clicks to choose an option.
 
 If disabled, it will show all options as buttons instead.
+

doc/helgobox/modules/ROOT/partials/generated/elements/settings/roundness.adoc

@@ -3,6 +3,5 @@
 
 image::generated/screenshots/elements/settings/roundness.png[Roundness]
 
-Determines whether to round off corners of various user interface elements and how much.
+Choose whether to round off corners of various user interface elements and how much.
 
-**Tip:** If you want slot cells with rounded corners, play with the cell color position setting!

doc/helgobox/modules/ROOT/partials/generated/elements/settings/theme-mode.adoc

@@ -4,3 +4,4 @@
 image::generated/screenshots/elements/settings/theme-mode.png[Theme mode]
 
 Switches between dark, light, and automatic theme modes. In automatic mode, the app will follow your system's theme settings.
+

doc/helgobox/modules/ROOT/partials/generated/elements/settings/use-context-coloring.adoc

@@ -3,4 +3,5 @@
 
 image::generated/screenshots/elements/settings/use-context-coloring.png[Use context coloring]
 
-If enabled, some inspector panels will get a special background color that reflects their purpose (e.g. red for recording and green for playback). This makes it easier to distinguish between the purpose of different settings but it may not go so well with the color design of your theme.
+If enabled, some inspector panels will get a special background color that reflects their purpose, such as red for recording and green for playback. This makes it easier to distinguish between the purpose of different settings but it may not go so well with the color design of your theme.
+

doc/helgobox/modules/ROOT/partials/generated/elements/settings/use-host-colors.adoc

@@ -4,3 +4,4 @@
 image::generated/screenshots/elements/settings/use-host-colors.png[Use host colors (experimental)]
 
 Borrows some color from the REAPER theme.
+

doc/helgobox/modules/ROOT/partials/generated/elements/title-bar/dim.adoc

@@ -4,3 +4,4 @@
 image:generated/screenshots/elements/title-bar/dim.png[Dim, role="related thumb right"]
 
 Toggles between a transparent and opaque window. Useful for quickly having a look what REAPER is doing under the hood ;)
+

doc/helgobox/modules/ROOT/partials/generated/elements/title-bar/full-screen.adoc

@@ -4,3 +4,4 @@
 image:generated/screenshots/elements/title-bar/full-screen.png[Full screen, role="related thumb right"]
 
 Toggles between full-screen and windowed mode.
+

doc/helgobox/modules/ROOT/partials/generated/elements/title-bar/helgobox-info.adoc

@@ -4,3 +4,4 @@
 image:generated/screenshots/elements/title-bar/helgobox-info.png[Helgobox Info, role="related thumb right"]
 
 Shows the version number of this Helgobox installation as well as the ID of the Helgobox instance to which this App window is connected.
+

doc/helgobox/modules/ROOT/partials/generated/elements/title-bar/help.adoc

@@ -4,3 +4,4 @@
 image:generated/screenshots/elements/title-bar/help.png[Help, role="related thumb right"]
 
 Shows a help menu
+

doc/helgobox/modules/ROOT/partials/generated/elements/title-bar/hide-window.adoc

@@ -5,3 +5,4 @@ image:generated/screenshots/elements/title-bar/hide-window.png[Hide window, role
 
 Hides the app window.
 
+

doc/helgobox/modules/ROOT/partials/generated/elements/title-bar/move-window.adoc

@@ -4,3 +4,4 @@
 image:generated/screenshots/elements/title-bar/move-window.png[Move window, role="related thumb right"]
 
 Drag this button to move the window. Useful when the window is very narrow, in which case the main drag area in the center will disappear.
+

doc/helgobox/modules/ROOT/partials/generated/elements/title-bar/panic-midi.adoc

@@ -4,3 +4,4 @@
 image:generated/screenshots/elements/title-bar/panic-midi.png[Panic, role="related thumb right"]
 
 Attempts to stops all currently playing MIDI notes. Whenever you experience hanging notes, press this button.
+

doc/helgobox/modules/ROOT/partials/generated/elements/title-bar/pause-arrangement.adoc

@@ -4,3 +4,4 @@
 image:generated/screenshots/elements/title-bar/pause-arrangement.png[Pause arrangement, role="related thumb right"]
 
 Pauses the REAPER arrangement
+

doc/helgobox/modules/ROOT/partials/generated/elements/title-bar/play-arrangement.adoc

@@ -4,3 +4,4 @@
 image:generated/screenshots/elements/title-bar/play-arrangement.png[Play arrangement, role="related thumb right"]
 
 Starts playing the REAPER arrangement
+

doc/helgobox/modules/ROOT/partials/generated/elements/title-bar/redo.adoc

@@ -4,3 +4,4 @@
 image:generated/screenshots/elements/title-bar/redo.png[Redo, role="related thumb right"]
 
 Redoes the most recent operation that was undone within this Playtime matrix.
+

doc/helgobox/modules/ROOT/partials/generated/elements/title-bar/refresh.adoc

@@ -6,3 +6,4 @@ image:generated/screenshots/elements/title-bar/refresh.png[Refresh, role="relate
 Refreshes the displayed information.
 
 Pressing this button is typically not required during normal operation. However, if there are any issues preventing Helgobox from displaying the latest information automatically, this button can help resolve the problem.
+

doc/helgobox/modules/ROOT/partials/generated/elements/title-bar/save-project.adoc

@@ -4,3 +4,4 @@
 image:generated/screenshots/elements/title-bar/save-project.png[Save project, role="related thumb right"]
 
 Saves the current REAPER project
+

doc/helgobox/modules/ROOT/partials/generated/elements/title-bar/settings.adoc

@@ -4,3 +4,4 @@
 image:generated/screenshots/elements/title-bar/settings.png[Settings, role="related thumb right"]
 
 Opens the central settings dialog.
+

doc/helgobox/modules/ROOT/partials/generated/elements/title-bar/stop-arrangement.adoc

@@ -4,3 +4,4 @@
 image:generated/screenshots/elements/title-bar/stop-arrangement.png[Stop arrangement, role="related thumb right"]
 
 Stops the REAPER arrangement
+

doc/helgobox/modules/ROOT/partials/generated/elements/title-bar/theme-mode.adoc

@@ -4,3 +4,4 @@
 image:generated/screenshots/elements/title-bar/theme-mode.png[Theme mode, role="related thumb right"]
 
 Switches between dark, light, and automatic theme modes. In automatic mode, the app will follow your system's theme settings.
+

doc/helgobox/modules/ROOT/partials/generated/elements/title-bar/theme-switcher.adoc

@@ -3,4 +3,5 @@
 
 image:generated/screenshots/elements/title-bar/theme-switcher.png[Quick theme switcher, role="related thumb right"]
 
-Allows you to cycle through all available themes.
+Cycle through all available themes.
+

doc/helgobox/modules/ROOT/partials/generated/elements/title-bar/toggle-nav-bar.adoc

@@ -4,3 +4,4 @@
 image:generated/screenshots/elements/title-bar/toggle-nav-bar.png[Toggle navigation bar, role="related thumb right"]
 
 Shows or hides the navigation bar on the left.
+

doc/helgobox/modules/ROOT/partials/generated/elements/title-bar/undo.adoc

@@ -4,3 +4,4 @@
 image:generated/screenshots/elements/title-bar/undo.png[Undo, role="related thumb right"]
 
 Undoes the most recent operation performed within this Playtime matrix.
+

doc/playtime/modules/ROOT/nav.adoc

@@ -18,6 +18,7 @@
 ** xref:user-interface/purchase-and-activate-dialog.adoc[]
 ** xref:user-interface/settings-dialog.adoc[]
 ** xref:user-interface/sequences-dialog.adoc[]
+** xref:user-interface/arrangement-writing-mode-dialog.adoc[]
 ** xref:user-interface/tempo-settings-dialog.adoc[]
 ** xref:user-interface/keyboard-shortcuts.adoc[]
 * xref:further-concepts.adoc[]

doc/playtime/modules/ROOT/pages/installation.adoc

@@ -8,4 +8,4 @@ If you don't see it, do this:
 . Select menu:Extensions[Helgobox > Show welcome screen]
 . Check "Add Playtime button to main toolbar"
 
-image::screenshots/helgobox-welcome-screen.png[]
+image::screenshots/helgobox-welcome-screen.png[width=500]

doc/playtime/modules/ROOT/pages/introduction.adoc

@@ -4,14 +4,11 @@ link:https://www.helgoboss.org/projects/playtime[Playtime] is a modern session v
 It is part of the link:https://www.helgoboss.org/projects/helgobox[Helgobox] plug-in.
 
 This reference offers a comprehensive guide to Playtime's concepts and features.
-Use it to dive deep into specific functionalities or to better understand how Playtime enhances your workflow.
 
 [IMPORTANT]
 ====
 
-**If you are a beginner, please use the link:https://github.com/helgoboss/helgobox/wiki/Playtime-Home[Playtime Wiki] instead!**
+**If you are a beginner, you also might want to check out the link:https://github.com/helgoboss/helgobox/wiki/Playtime-Home[Playtime Wiki]!**
 
-This reference is targeted at users who are already familiar with the Playtime basics and want to look up specific information.
-The Wiki is perfect if you are just starting off.
 It guides you through the very basics and contains links to easily digestible video tutorials.
 ====

doc/playtime/modules/ROOT/pages/user-interface/arrangement-writing-mode-dialog.adoc

@@ -0,0 +1,7 @@
+= Arrangement writing mode dialog
+
+image::generated/screenshots/main/arrangement-writing-mode.png[]
+
+include::partial$generated/elements/arrangement-writing-mode/replace.adoc[]
+include::partial$generated/elements/arrangement-writing-mode/merge-at-cursor.adoc[]
+include::partial$generated/elements/arrangement-writing-mode/append.adoc[]