diff --git a/src/public/app/doc_notes/launchbar_command_launcher.html b/src/public/app/doc_notes/launchbar_command_launcher.html
index 68eb051a2..eb228f06a 100644
--- a/src/public/app/doc_notes/launchbar_command_launcher.html
+++ b/src/public/app/doc_notes/launchbar_command_launcher.html
@@ -1 +1 @@
-<p>Keyboard shortcut for this launcher action can be configured in Options -> Shortcuts.</p>
+<p>Keyboard launcher for this launcher action can be configured in Options -> Launchers.</p>
diff --git a/src/public/app/doc_notes/launchbar_intro.html b/src/public/app/doc_notes/launchbar_intro.html
index 1281f6fc8..cac5224e9 100644
--- a/src/public/app/doc_notes/launchbar_intro.html
+++ b/src/public/app/doc_notes/launchbar_intro.html
@@ -3,9 +3,9 @@
 <p>You can do the following things here:</p>
 
 <ul>
-    <li>Move available shortcuts to the visible list (thus putting them into the launchbar) by dragging them</li>
-    <li>Move visible shortcuts to the available list (thus hiding them from the launchbar) by dragging them</li>
+    <li>Move available launchers to the visible list (thus putting them into the launchbar) by dragging them</li>
+    <li>Move visible launchers to the available list (thus hiding them from the launchbar) by dragging them</li>
     <li>You can reorder the items in the lists by dragging</li>
-    <li>You can create new shortcuts by right-clicking on the "Visible shortcuts" folder</li>
-    <li>If you want to get back to the default setup, just delete the "Visible shortcuts" and "Available shortcuts", the default configuration will be re-created.</li>
-</ul>
\ No newline at end of file
+    <li>You can create new launchers by right-clicking on the "Visible launchers" folder</li>
+    <li>If you want to get back to the default setup, you can find "reset" in the context menu.</li>
+</ul>
diff --git a/src/public/app/doc_notes/launchbar_note_launcher.html b/src/public/app/doc_notes/launchbar_note_launcher.html
index 8cb967877..74b28296a 100644
--- a/src/public/app/doc_notes/launchbar_note_launcher.html
+++ b/src/public/app/doc_notes/launchbar_note_launcher.html
@@ -1,9 +1,9 @@
 <p>You can define the following attributes:</p>
 
 <ol>
-    <li><code>targetNote</code> - note which should be opened upon activating the launcher</li>
+    <li><code>target</code> - note which should be opened upon activating the launcher</li>
     <li><code>hoistedNote</code> - optional, will change the hoisted note before opening the target note</li>
-    <li><code>keyboardShortcut</code> - optional, pressing the keyboard shortcut will open the note</li>
+    <li><code>keyboardLauncher</code> - optional, pressing the keyboard launcher will open the note</li>
 </ol>
 
-<p>Launchbar displays the title / icon from the shortcut which does not necessarily mirrors those of the target note.</p>
+<p>Launchbar displays the title / icon from the launcher which does not necessarily mirrors those of the target note.</p>
diff --git a/src/public/app/doc_notes/launchbar_script_launcher.html b/src/public/app/doc_notes/launchbar_script_launcher.html
index 39168e1c7..82c9d496c 100644
--- a/src/public/app/doc_notes/launchbar_script_launcher.html
+++ b/src/public/app/doc_notes/launchbar_script_launcher.html
@@ -1,6 +1,9 @@
-<p>Please define the target script note in the promoted attributes. This script will be executed immediately upon clicking the launchbar icon.</p>
+<p>Script launcher can execute a script (code note) connected via <code>~script</code> relation.</p>
 
-<p>Launchbar displays the title / icon from the shortcut which does not necessarily mirrors those of the target script note.</p>
+<ol>
+    <li><code>script</code> - relation to the script note which should be executed upon launcher activation</li>
+    <li><code>keyboardLauncher</code> - optional, pressing the keyboard launcher will activate the launcher</li>
+</ol>
 
 <h4>Example script</h4>
 
diff --git a/src/public/app/doc_notes/launchbar_spacer.html b/src/public/app/doc_notes/launchbar_spacer.html
index 3390763ca..720899a73 100644
--- a/src/public/app/doc_notes/launchbar_spacer.html
+++ b/src/public/app/doc_notes/launchbar_spacer.html
@@ -1,4 +1,4 @@
-<p>Spacer allows you to visually group shortcuts. You can configure it in the promoted attributes:</p>
+<p>Spacer allows you to visually group launchers. You can configure it in the promoted attributes:</p>
 
 <ul>
     <li><code>baseSize</code> - defines size in pixels (if there's enough space)</li>
diff --git a/src/services/migration.js b/src/services/migration.js
index a5ac2be4f..a9e5d1799 100644
--- a/src/services/migration.js
+++ b/src/services/migration.js
@@ -46,6 +46,8 @@ async function migrate() {
     migrations.sort((a, b) => a.dbVersion - b.dbVersion);
 
     // all migrations are executed in one transaction - upgrade either succeeds or the user can stay at the old version
+    // otherwise if half of the migrations succeed, user can't use any version - DB is too "new" for the old app,
+    // and too old for the new app version.
     sql.transactional(() => {
         for (const mig of migrations) {
             try {