From 5592b91152f91999a4720382bdb68fdd71c966a1 Mon Sep 17 00:00:00 2001 From: Trang Doan Date: Fri, 24 Jul 2026 09:11:33 -0400 Subject: [PATCH 1/4] ENG-2064 Update Obsidian installation instruction MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Reorder the install steps to follow the dependency chain (BRAT → Datacore → Discourse Graphs) so the required Datacore plugin is installed before Discourse Graphs. Co-Authored-By: Claude Opus 4.8 (1M context) --- apps/obsidian/README.md | 33 ++++++++++++++++++--------------- 1 file changed, 18 insertions(+), 15 deletions(-) diff --git a/apps/obsidian/README.md b/apps/obsidian/README.md index 7e51fe49f..05cab4b8c 100644 --- a/apps/obsidian/README.md +++ b/apps/obsidian/README.md @@ -10,30 +10,33 @@ Break down the research process into atomic units to augment the knowledge synth # Installation -Follow the instructions below to install the plugin: +Discourse Graphs depends on the Datacore plugin, which isn't yet in Obsidian's community plugin browser, so you install it through BRAT (Beta Reviewer's Auto-update Tester). Complete these steps in order: **BRAT → Datacore → Discourse Graphs**. -## Install BRAT +## 1. Install BRAT -To use the plugin prior to its public release on Obsidian's community plugin browser, install BRAT (Beta Reviewer's Auto-update Tester). +BRAT lets you install plugins that aren't yet published to Obsidian's community plugin browser. -1. Open Obsidian Settings -2. Go to Community Plugins and disable Restricted Mode -3. Click "Browse" and search for "BRAT" -4. Install BRAT and enable it +1. Open Obsidian settings +2. Go to Community plugins and disable Restricted Mode +3. Click "Browse", search for "BRAT", then install and enable it -## Install DataCore via BRAT +## 2. Install Datacore via BRAT -1. Add the DataCore plugin from the BRAT settings menu or run command "Add a beta plugin for testing" -2. Enter the repository URL: `https://github.com/blacksmithgu/datacore` and choose "Latest version" +Datacore is required for Discourse Graphs to work, so install it before the Discourse Graphs plugin. + +1. Run the command "Add a beta plugin for testing", or open the BRAT settings menu and click `Add beta plugin` +2. Enter the repository URL `https://github.com/blacksmithgu/datacore` and choose "Latest version" 3. Check the box for "Enable after installing the plugin" 4. Click `Add plugin` -## Install Discourse Graphs +## 3. Install Discourse Graphs -1. Add the Discourse Graphs plugin from the BRAT settings menu or run command `Add a beta plugin for testing` -2. Enter the repository URL: `https://github.com/DiscourseGraphs/discourse-graph-obsidian` and choose "Latest version" -3. Check the box for "Enable after installing the plugin" -4. Click `Add plugin` +Once Datacore is installed and enabled, add the Discourse Graphs plugin from Obsidian's community plugin browser: + +1. Open Obsidian → Settings → Community plugins → Browse +2. Search for "Discourse Graph", then install and enable it + +Or install directly from the [community plugin page](https://community.obsidian.md/plugins/discourse-graphs). # Getting started From ba13c3d35edfe8ca515ac1508a49503751f5f8c2 Mon Sep 17 00:00:00 2001 From: Trang Doan Date: Fri, 24 Jul 2026 11:19:57 -0400 Subject: [PATCH 2/4] ENG-2064 Install Datacore via community plugin browser Datacore is now available in Obsidian's community plugin browser, so drop the BRAT flow entirely. Both the website installation page and the plugin README now install Datacore, then Discourse Graphs, directly from Community plugins. Co-Authored-By: Claude Opus 4.8 (1M context) --- apps/obsidian/README.md | 19 +++----- .../content/obsidian/welcome/installation.md | 45 +++++-------------- 2 files changed, 17 insertions(+), 47 deletions(-) diff --git a/apps/obsidian/README.md b/apps/obsidian/README.md index 05cab4b8c..2b89dcfad 100644 --- a/apps/obsidian/README.md +++ b/apps/obsidian/README.md @@ -10,26 +10,17 @@ Break down the research process into atomic units to augment the knowledge synth # Installation -Discourse Graphs depends on the Datacore plugin, which isn't yet in Obsidian's community plugin browser, so you install it through BRAT (Beta Reviewer's Auto-update Tester). Complete these steps in order: **BRAT → Datacore → Discourse Graphs**. +Discourse Graphs depends on the Datacore plugin, so install Datacore first. Both plugins are available in Obsidian's community plugin browser. -## 1. Install BRAT +## 1. Install Datacore -BRAT lets you install plugins that aren't yet published to Obsidian's community plugin browser. +Datacore is required for Discourse Graphs to work, so install and enable it before the Discourse Graphs plugin. 1. Open Obsidian settings 2. Go to Community plugins and disable Restricted Mode -3. Click "Browse", search for "BRAT", then install and enable it +3. Click "Browse", search for "Datacore", then install and enable it -## 2. Install Datacore via BRAT - -Datacore is required for Discourse Graphs to work, so install it before the Discourse Graphs plugin. - -1. Run the command "Add a beta plugin for testing", or open the BRAT settings menu and click `Add beta plugin` -2. Enter the repository URL `https://github.com/blacksmithgu/datacore` and choose "Latest version" -3. Check the box for "Enable after installing the plugin" -4. Click `Add plugin` - -## 3. Install Discourse Graphs +## 2. Install Discourse Graphs Once Datacore is installed and enabled, add the Discourse Graphs plugin from Obsidian's community plugin browser: diff --git a/apps/website/content/obsidian/welcome/installation.md b/apps/website/content/obsidian/welcome/installation.md index 0360eab06..d267688d7 100644 --- a/apps/website/content/obsidian/welcome/installation.md +++ b/apps/website/content/obsidian/welcome/installation.md @@ -5,46 +5,25 @@ author: "" published: true --- -## Prerequisites +Discourse Graphs depends on the Datacore plugin, so install Datacore first. Both plugins are available in Obsidian's community plugin browser. -### Install BRAT (Beta Reviewer's Auto-update Tester) +## Requirements -1. Open Obsidian Settings -2. Go to Community Plugins and disable Restricted Mode -3. Click "Browse" and search for "BRAT" - ![BRAT](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2Faar5LKpLOk.png?alt=media&token=6f51ac48-19d3-4bb5-9a07-7b32cfa6afe6) -4. Install BRAT and enable it +### Install Datacore -### Install DataCore via BRAT +Datacore is required for Discourse Graphs to work, so install and enable it before the Discourse Graphs plugin. 1. Open Obsidian Settings -2. Go to "Community Plugins" → "BRAT" -3. Click "Add Beta Plugin" - ![Add plugin](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2FdMtstUHPXe.png?alt=media&token=3f139ab9-9802-404d-9554-4a63bac080c5) -4. Enter the repository URL below and choose "Latest version" - -``` -https://github.com/blacksmithgu/datacore -``` - -![Add datacore](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2FEY3vNGt1Rf.png?alt=media&token=32c60ff1-5272-4cde-8b5f-8f049fb2cf50) - -5. Check the box for "Enable after installing the plugin" -6. Click "Add plugin" +2. Go to "Community plugins" and disable Restricted Mode +3. Click "Browse" and search for "Datacore" +4. Install Datacore and enable it ## Install Discourse Graphs -1. Open Obsidian Settings -2. Go to "Community Plugins" → "BRAT" -3. Click "Add Beta Plugin" - ![Add plugin](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2FdMtstUHPXe.png?alt=media&token=3f139ab9-9802-404d-9554-4a63bac080c5) -4. Enter the repository URL below and choose "Latest version" - -``` -https://github.com/DiscourseGraphs/discourse-graph-obsidian -``` +Once Datacore is installed and enabled, add the Discourse Graphs plugin from the community plugin browser. -![Add discourse graph](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2FSBCK-2lkcu.png?alt=media&token=0375c828-da4d-43b4-8f2c-e691692cb019) +1. Open Obsidian Settings +2. Go to "Community plugins" → "Browse" +3. Search for "Discourse Graph", then install and enable it -5. Check the box for "Enable after installing the plugin" -6. Click "Add Plugin" +Or install directly from the [community plugin page](https://community.obsidian.md/plugins/discourse-graphs). From 68e5d772294f84cd6aae6643eef1621f5c6bff79 Mon Sep 17 00:00:00 2001 From: johnny1093 <46250921+jsmorabito@users.noreply.github.com> Date: Fri, 24 Jul 2026 12:55:46 -0400 Subject: [PATCH 3/4] Update apps/website/content/obsidian/welcome/installation.md Co-authored-by: graphite-app[bot] <96075541+graphite-app[bot]@users.noreply.github.com> --- apps/website/content/obsidian/welcome/installation.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/apps/website/content/obsidian/welcome/installation.md b/apps/website/content/obsidian/welcome/installation.md index d267688d7..0bee79cd3 100644 --- a/apps/website/content/obsidian/welcome/installation.md +++ b/apps/website/content/obsidian/welcome/installation.md @@ -24,6 +24,7 @@ Once Datacore is installed and enabled, add the Discourse Graphs plugin from the 1. Open Obsidian Settings 2. Go to "Community plugins" → "Browse" -3. Search for "Discourse Graph", then install and enable it +3. Search for "Discourse Graphs", then install and enable it + Or install directly from the [community plugin page](https://community.obsidian.md/plugins/discourse-graphs). From cb8d24937f54b4c2b137c009dd6101b7e7a20370 Mon Sep 17 00:00:00 2001 From: Trang Doan Date: Fri, 24 Jul 2026 17:48:40 -0400 Subject: [PATCH 4/4] ENG-2064 Fix installation doc formatting and align plugin search name Collapse the stray double blank line in installation.md so Prettier passes, and update the README search term to "Discourse Graphs" to match the website doc. Co-Authored-By: Claude Opus 4.8 (1M context) --- apps/obsidian/README.md | 2 +- apps/website/content/obsidian/welcome/installation.md | 1 - 2 files changed, 1 insertion(+), 2 deletions(-) diff --git a/apps/obsidian/README.md b/apps/obsidian/README.md index 2b89dcfad..281b746ac 100644 --- a/apps/obsidian/README.md +++ b/apps/obsidian/README.md @@ -25,7 +25,7 @@ Datacore is required for Discourse Graphs to work, so install and enable it befo Once Datacore is installed and enabled, add the Discourse Graphs plugin from Obsidian's community plugin browser: 1. Open Obsidian → Settings → Community plugins → Browse -2. Search for "Discourse Graph", then install and enable it +2. Search for "Discourse Graphs", then install and enable it Or install directly from the [community plugin page](https://community.obsidian.md/plugins/discourse-graphs). diff --git a/apps/website/content/obsidian/welcome/installation.md b/apps/website/content/obsidian/welcome/installation.md index 0bee79cd3..35bc0f751 100644 --- a/apps/website/content/obsidian/welcome/installation.md +++ b/apps/website/content/obsidian/welcome/installation.md @@ -26,5 +26,4 @@ Once Datacore is installed and enabled, add the Discourse Graphs plugin from the 2. Go to "Community plugins" → "Browse" 3. Search for "Discourse Graphs", then install and enable it - Or install directly from the [community plugin page](https://community.obsidian.md/plugins/discourse-graphs).