From a05c4f4d64d915614852ea6da8c8107c6bda92db Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Fri, 27 Mar 2026 18:48:40 +0000 Subject: [PATCH 1/2] docs: add documentation for customizing node menu hotkey - Enhanced command palette docs to explain hotkey customization - Added section on useful hotkeys to configure including node menu - Updated creating discourse nodes docs with info about customizing the default Cmd+\ hotkey - Added link to command palette docs for hotkey customization - Clarified that node menu can be used without text selection to create new nodes Resolves ENG-1581 Co-authored-by: Trang Doan --- .../docs/obsidian/pages/command-palette.md | 16 ++++++++++++---- .../obsidian/pages/creating-discourse-nodes.md | 7 +++++-- 2 files changed, 17 insertions(+), 6 deletions(-) diff --git a/apps/website/app/(docs)/docs/obsidian/pages/command-palette.md b/apps/website/app/(docs)/docs/obsidian/pages/command-palette.md index 620368949..cd96c95f4 100644 --- a/apps/website/app/(docs)/docs/obsidian/pages/command-palette.md +++ b/apps/website/app/(docs)/docs/obsidian/pages/command-palette.md @@ -13,11 +13,19 @@ The Command Palette is a powerful way to access all Discourse Graph features wit 2. Type "Discourse" to see all available commands ![command palette](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2F5ybScaQISO.png?alt=media&token=2b36f0e7-4247-47b7-a53d-c784dfd4609b) -## Customizing Commands +## Customizing hotkeys -You can customize how commands appear in the Command Palette: +You can set custom hotkeys for Discourse Graph commands to speed up your workflow: 1. Open Obsidian Settings 2. Go to "Hotkeys" -3. Search for "Discourse" -4. Modify the commands or add hotkeys +3. Search for "Discourse" to see all available commands +4. Click on a command and set your preferred hotkey + +### Useful hotkeys to configure + +- **Open node type menu**: Create a new discourse node or convert selected text into a node +- **Toggle discourse context**: Show or hide the discourse context view +- **Create discourse node**: Create a new discourse node from scratch + +For example, setting a hotkey for "Open node type menu" allows you to quickly create new discourse nodes without using the mouse. diff --git a/apps/website/app/(docs)/docs/obsidian/pages/creating-discourse-nodes.md b/apps/website/app/(docs)/docs/obsidian/pages/creating-discourse-nodes.md index c58676a79..907023022 100644 --- a/apps/website/app/(docs)/docs/obsidian/pages/creating-discourse-nodes.md +++ b/apps/website/app/(docs)/docs/obsidian/pages/creating-discourse-nodes.md @@ -14,17 +14,20 @@ To create a discourse node, first select the text you want to turn into a node: There are two ways you can create a node: ### 1. Using command keys (recommended) + +The default hotkey is `Cmd + \` (or `Ctrl + \` on Windows/Linux). You can [customize this hotkey](./command-palette#customizing-hotkeys) in Obsidian's settings under Hotkeys → "Open node type menu". + #### 1.1 Turn selected text into discourse node 1. Press `Cmd + \` (or your configured hotkey) -2. The Node Menu will open as a popup +2. The node menu will open as a popup ![node menu](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2FS6eU6y70eX.png?alt=media&token=00e61ddf-877b-4752-a65b-272e80a0a19c) 3. Select the node type you want to turn the text into 4. A new discourse node will be created ![node created](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2F1VNkJC0aH8.png?alt=media&token=df9a26aa-997b-4b56-a307-87a80e350b28) #### 1.2 Creating new node from scratch -1. Press `Cmd + \` (or your configured hotkey) +1. Press `Cmd + \` (or your configured hotkey) without selecting any text 2. Enter the title and node type ![](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2FyYxtLKkx6B.png?alt=media&token=7f4f02df-d1fe-4529-8530-90acb0dc74b8) From 0df4377104c0ca5ad32b4ed3cc537129cd437593 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Fri, 27 Mar 2026 19:08:06 +0000 Subject: [PATCH 2/2] docs: remove references to default Cmd+\ hotkey - Removed mentions of default Cmd+\ hotkey as it no longer exists - Changed section title from 'Using command keys' to 'Using a hotkey' - Updated instructions to direct users to set up a hotkey first - Simplified steps to refer to 'your configured hotkey' instead of specific keys Co-authored-by: Trang Doan --- .../docs/obsidian/pages/creating-discourse-nodes.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/apps/website/app/(docs)/docs/obsidian/pages/creating-discourse-nodes.md b/apps/website/app/(docs)/docs/obsidian/pages/creating-discourse-nodes.md index 907023022..84e992bd6 100644 --- a/apps/website/app/(docs)/docs/obsidian/pages/creating-discourse-nodes.md +++ b/apps/website/app/(docs)/docs/obsidian/pages/creating-discourse-nodes.md @@ -13,13 +13,13 @@ To create a discourse node, first select the text you want to turn into a node: There are two ways you can create a node: -### 1. Using command keys (recommended) +### 1. Using a hotkey (recommended) -The default hotkey is `Cmd + \` (or `Ctrl + \` on Windows/Linux). You can [customize this hotkey](./command-palette#customizing-hotkeys) in Obsidian's settings under Hotkeys → "Open node type menu". +To use this method, first [set up a hotkey](./command-palette#customizing-hotkeys) in Obsidian's settings under Hotkeys → "Open node type menu". #### 1.1 Turn selected text into discourse node -1. Press `Cmd + \` (or your configured hotkey) +1. Press your configured hotkey 2. The node menu will open as a popup ![node menu](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2FS6eU6y70eX.png?alt=media&token=00e61ddf-877b-4752-a65b-272e80a0a19c) 3. Select the node type you want to turn the text into @@ -27,7 +27,7 @@ The default hotkey is `Cmd + \` (or `Ctrl + \` on Windows/Linux). You can [custo ![node created](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2F1VNkJC0aH8.png?alt=media&token=df9a26aa-997b-4b56-a307-87a80e350b28) #### 1.2 Creating new node from scratch -1. Press `Cmd + \` (or your configured hotkey) without selecting any text +1. Press your configured hotkey without selecting any text 2. Enter the title and node type ![](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2FyYxtLKkx6B.png?alt=media&token=7f4f02df-d1fe-4529-8530-90acb0dc74b8)