ENG-892 - Use sentence case for discourse labels and docs (#700)

* Use sentence case for discourse labels

* more

* more more

* .

Author: mdroidian

apps/obsidian/README.md

@@ -19,17 +19,17 @@ For more information about Discourse Graphs, check out our website at [https://d
 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)
+   ![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 via BRAT
 
 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)
+   ![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: `https://github.com/blacksmithgu/datacore` and choose "Latest version"
-![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)
+   ![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"
 
@@ -38,101 +38,103 @@ For more information about Discourse Graphs, check out our website at [https://d
 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)
+   ![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: `https://github.com/DiscourseGraphs/discourse-graph-obsidian`  and choose "Latest version"
-![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)
+4. Enter the repository URL: `https://github.com/DiscourseGraphs/discourse-graph-obsidian` and choose "Latest version"
+   ![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)
 5. Check the box for "Enable after installing the plugin"
 6. Click "Add Plugin"
 
-
 ## Creating Nodes and Relationships
 
 ### Configure Node and Relationship Types
 
 1. Open Obsidian Settings
 2. Navigate to the "Discourse Graphs" settings tab
+
 #### Edit Node Types
-   - Under "Node Types," click "Add Node Type"
-   - Enter a name for your node type (e.g., "Claim", "Evidence", "Question")
-   - Add the format for your node type. eg a claim node will have page title "CLM - {content}"
-   - **Template (Optional)**: Select a template from the dropdown to automatically apply template content when creating nodes of this type
-     - Templates are sourced from Obsidian's core Templates plugin
-     - Ensure you have the Templates plugin enabled and configured with a template folder
-     - The dropdown will show all available template files from your configured template folder
-
-      ![add node types with template](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2FHMg_Tq6qiR.png?alt=media&token=69828bfc-c939-41b0-abd4-2cc8931c5a38)
-     - Click "Save Changes"
-
-    
+
+- Under "Node Types," click "Add Node Type"
+- Enter a name for your node type (e.g., "Claim", "Evidence", "Question")
+- Add the format for your node type. eg a claim node will have page title "CLM - {content}"
+- **Template (Optional)**: Select a template from the dropdown to automatically apply template content when creating nodes of this type
+  - Templates are sourced from Obsidian's core Templates plugin
+  - Ensure you have the Templates plugin enabled and configured with a template folder
+  - The dropdown will show all available template files from your configured template folder
+
+  ![add node types with template](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2FHMg_Tq6qiR.png?alt=media&token=69828bfc-c939-41b0-abd4-2cc8931c5a38)
+  - Click "Save Changes"
+
 - To create a new template:
-  + Create new folder to store templates
-  ![new folder](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2FyTtJ1a0iI2.png?alt=media&token=b5d09b10-f170-47cd-a239-ee5f7acd89dc)
+  - Create new folder to store templates
+    ![new folder](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2FyTtJ1a0iI2.png?alt=media&token=b5d09b10-f170-47cd-a239-ee5f7acd89dc)
 
-  + Specify template folder location in plugin settings menu
-  ![template](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2FhzZg_GJXY9.png?alt=media&token=508c8d19-1f13-4fb3-adf1-898dcf694f08)
+  - Specify template folder location in plugin settings menu
+    ![template](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2FhzZg_GJXY9.png?alt=media&token=508c8d19-1f13-4fb3-adf1-898dcf694f08)
 
-  + Create new file in template folder (A) and add text to file (B)
-  ![create template file](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2FtTr9vOnXnX.png?alt=media&token=dda1fe25-3ccf-42b4-8f3c-1cd29f82c3f7)
+  - Create new file in template folder (A) and add text to file (B)
+    ![create template file](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2FtTr9vOnXnX.png?alt=media&token=dda1fe25-3ccf-42b4-8f3c-1cd29f82c3f7)
 
   ![add node types](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2FYRZ6ocI_d-.png?alt=media&token=c623bec7-02bd-42b4-a994-cd1c40a54d82)
   - Click "Save Changes"
+
 #### Edit Relation Types
-   - Under "Relation Types," click "Add Relationship Type"
-   - A relation type is a kind of relationship that can exist between any two node types
-   - Enter a name for your relationship (e.g., "supports", "contradicts")
-   - Enter the complement label (e.g., "is supported by", "is contradicted by")
-   ![add relation type](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2Fjk367dcO_K.png?alt=media&token=22d74e9f-882c-434b-8b50-afd7a754fb2b)
-   - Click "Save Changes"
+
+- Under "Relation Types," click "Add Relationship Type"
+- A relation type is a kind of relationship that can exist between any two node types
+- Enter a name for your relationship (e.g., "supports", "contradicts")
+- Enter the complement label (e.g., "is supported by", "is contradicted by")
+  ![add relation type](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2Fjk367dcO_K.png?alt=media&token=22d74e9f-882c-434b-8b50-afd7a754fb2b)
+- Click "Save Changes"
+
 #### Define possible relations between nodes
+
 - Open the Discourse Relations tab in the Discourse Graph settings
-![discourse relation](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2FNgm7Ha4Ul5.png?alt=media&token=a933bd3a-d9a6-42c1-9c6e-d779d41c7ebf)
+  ![discourse relation](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2FNgm7Ha4Ul5.png?alt=media&token=a933bd3a-d9a6-42c1-9c6e-d779d41c7ebf)
 - Choose Source Node Type, Relation Type, and Target Node Type
-![choose relation](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2FlflJBkfdaK.png?alt=media&token=5de9617c-6099-46e8-931f-feafc604cabb)
+  ![choose relation](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2FlflJBkfdaK.png?alt=media&token=5de9617c-6099-46e8-931f-feafc604cabb)
 - Once you see the source, relation, and target selected:
-![final relations](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2FycPW-N-rY8.png?alt=media&token=54867be2-9030-4c6c-82d2-b96069e52d81)
-E.g: this means that *Claim* nodes can supports *Questions* nodes
+  ![final relations](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2FycPW-N-rY8.png?alt=media&token=54867be2-9030-4c6c-82d2-b96069e52d81)
+  E.g: this means that _Claim_ nodes can supports _Questions_ nodes
 - Click "Save changes"
 
 ## Using Discourse Graphs
 
 ### Instantiate a Node
 
 - Select the text you want to turn into a Discourse Node
-![select text](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2FInIer-iPGs.png?alt=media&token=fad214f6-f426-4249-8b0a-d5a403894600)
+  ![select text](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2FInIer-iPGs.png?alt=media&token=fad214f6-f426-4249-8b0a-d5a403894600)
 - There are two ways you can create a node from here:
-  
-  1. Using command keys: Cmd + \ 
-  <br>
+  1. Using command keys: Cmd + \
+     <br>
   - As you press these keys, the Node Menu will open up 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)
   - Select the node type you want to turn the text into
   - Voila, you've created a new discourse node
-  ![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)
-  
+    ![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)
   2. Right-click menu:
   - Alternatively, you can right-click on the selected text
-  ![right click menu](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2F4UqeVkqLz7.png?alt=media&token=d2373152-d251-45fe-afb6-56373d6092aa)
-  - Then choose a node type from the "Turn into Discourse Node" menu
+    ![right click menu](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2F4UqeVkqLz7.png?alt=media&token=d2373152-d251-45fe-afb6-56373d6092aa)
+  - Then choose a node type from the "Turn into discourse node" menu
 
 ### Open Discourse Context
 
--  Click on the telescope icon on the left bar
-![open discourse context](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2FE10krHZcDM.png?alt=media&token=c1796a9f-7e51-437f-913d-91f5433d9bab)
+- Click on the telescope icon on the left bar
+  ![open discourse context](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2FE10krHZcDM.png?alt=media&token=c1796a9f-7e51-437f-913d-91f5433d9bab)
 - Alternatively, you can set a hotkey to toggle the Discourse Context view or access it via the Command Palette
-![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)
+  ![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)
 
 ### Instantiate a Relationship
 
 1. Open a note that you want to create a relationship from
 2. Open the Discourse Context
-![open discourse context](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2FE10krHZcDM.png?alt=media&token=c1796a9f-7e51-437f-913d-91f5433d9bab)
+   ![open discourse context](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2FE10krHZcDM.png?alt=media&token=c1796a9f-7e51-437f-913d-91f5433d9bab)
 3. Click "Add a new relation"
 4. The dropdown that shows Relationship Types will be all available relations that you have defined in the setings.
-<br> It will also show you what node type you can link with
-![add relation](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2FXQsgznWuV2.png?alt=media&token=9442b9fa-0904-4847-8eb8-a5791705c4c5)
+   <br> It will also show you what node type you can link with
+   ![add relation](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2FXQsgznWuV2.png?alt=media&token=9442b9fa-0904-4847-8eb8-a5791705c4c5)
 5. Search the nodes you want to link with by the title
-![search](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2F4NW4UjYDrC.png?alt=media&token=bae307d0-ebec-4e6b-a03d-0943d9d03754)
+   ![search](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2F4NW4UjYDrC.png?alt=media&token=bae307d0-ebec-4e6b-a03d-0943d9d03754)
 6. Click "Confirm", now a new relationship has been created
-![relationship created](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2FK8XAhCqrUL.png?alt=media&token=a559c477-c7f6-4b3e-8b00-ece7da5d4fec)
+   ![relationship created](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fdiscourse-graphs%2FK8XAhCqrUL.png?alt=media&token=a559c477-c7f6-4b3e-8b00-ece7da5d4fec)

apps/obsidian/src/components/BulkIdentifyDiscourseNodesModal.tsx

@@ -379,7 +379,7 @@ const BulkImportContent = ({ plugin, onClose }: BulkImportModalProps) => {
             className="!bg-accent !text-on-accent rounded px-4 py-2"
             disabled={candidates.filter((c) => c.selected).length === 0}
           >
-            Identify Selected as Discourse Nodes (
+            Identify selected as discourse nodes (
             {candidates.filter((c) => c.selected).length})
           </button>
         </div>
@@ -389,7 +389,7 @@ const BulkImportContent = ({ plugin, onClose }: BulkImportModalProps) => {
 
   const renderIdentifyingStep = () => (
     <div className="text-center">
-      <h3 className="mb-4">Identifying Files as Discourse Nodes</h3>
+      <h3 className="mb-4">Identifying files as discourse nodes</h3>
       <div className="mb-4">
         <div className="bg-modifier-border mb-2 h-2 rounded-full">
           <div

apps/obsidian/src/components/DiscourseContextView.tsx

@@ -78,7 +78,7 @@ const DiscourseContext = ({ activeFile }: DiscourseContextProps) => {
 
   return (
     <div>
-      <h3 className="dg-h3">Discourse Context</h3>
+      <h3 className="dg-h3">Discourse context</h3>
       {renderContent()}
     </div>
   );
@@ -104,7 +104,7 @@ export class DiscourseContextView extends ItemView {
   }
 
   getDisplayText(): string {
-    return "Discourse Context";
+    return "Discourse context";
   }
 
   getIcon(): string {

apps/obsidian/src/components/GeneralSettings.tsx

@@ -231,9 +231,9 @@ const GeneralSettings = () => {
 
       <div className="setting-item">
         <div className="setting-item-info">
-          <div className="setting-item-name">Discourse Nodes folder path</div>
+          <div className="setting-item-name">Discourse nodes folder path</div>
           <div className="setting-item-description">
-            Specify the folder where new Discourse Nodes should be created.
+            Specify the folder where new discourse nodes should be created.
             Leave empty to create nodes in the root folder.
           </div>
         </div>

apps/obsidian/src/components/ModifyNodeModal.tsx

@@ -256,7 +256,7 @@ export const ModifyNodeForm = ({
 
   return (
     <div>
-      <h2>{isEditMode ? "Modify Discourse Node" : "Create Discourse Node"}</h2>
+      <h2>{isEditMode ? "Modify discourse node" : "Create discourse node"}</h2>
       <div className="setting-item">
         <div className="setting-item-name">Type</div>
         <div className="setting-item-control">
@@ -466,4 +466,4 @@ class ModifyNodeModal extends Modal {
     contentEl.empty();
   }
 }
-export default ModifyNodeModal;
+export default ModifyNodeModal;

apps/obsidian/src/components/canvas/TldrawViewComponent.tsx

@@ -384,7 +384,7 @@ export const TldrawPreviewComponent = ({
               tools: (editor, tools) => {
                 tools["discourse-node"] = {
                   id: "discourse-node",
-                  label: "Discourse Node",
+                  label: "Discourse node",
                   readonlyOk: false,
                   icon: "discourseNodeIcon",
                   onSelect: () => {
@@ -393,7 +393,7 @@ export const TldrawPreviewComponent = ({
                 };
                 tools["discourse-relation"] = {
                   id: "discourse-relation",
-                  label: "Discourse Relation",
+                  label: "Discourse relation",
                   readonlyOk: false,
                   icon: "tool-arrow",
                   onSelect: () => {

apps/obsidian/src/components/canvas/shapes/nodeConstants.ts

@@ -1,7 +1,7 @@
 /**
- * Constants for Discourse Node styling and sizing.
+ * Constants for discourse node styling and sizing.
  * These values match the Tailwind classes used in DiscourseNodeShape component.
- * 
+ *
  * IMPORTANT: If you change these values, you must also update:
  * - The Tailwind classes in DiscourseNodeShape.tsx (line ~263)
  * - The measurement function in measureNodeText.ts
@@ -44,4 +44,3 @@ export const IMAGE_GAP = 4;
 
 // Base height for nodes without images (estimated)
 export const BASE_HEIGHT_NO_IMAGE = 100;
-

apps/obsidian/src/index.ts

@@ -109,7 +109,7 @@ export default class DiscourseGraphPlugin extends Plugin {
       (leaf) => new DiscourseContextView(leaf, this),
     );
 
-    this.addRibbonIcon("telescope", "Toggle Discourse Context", () => {
+    this.addRibbonIcon("telescope", "Toggle discourse context", () => {
       this.toggleDiscourseContextView();
     });
 
@@ -181,7 +181,7 @@ export default class DiscourseGraphPlugin extends Plugin {
         if (!editor.getSelection()) return;
 
         menu.addItem((menuItem) => {
-          menuItem.setTitle("Turn into Discourse Node");
+          menuItem.setTitle("Turn into discourse node");
           menuItem.setIcon("file-type");
 
           // Create submenu using the unofficial API pattern

apps/obsidian/src/services/QueryEngine.ts

@@ -38,7 +38,7 @@ export class QueryEngine {
   }
 
   /**
-   * Search across all Discourse Nodes (files that have frontmatter nodeTypeId)
+   * Search across all discourse nodes (files that have frontmatter nodeTypeId)
    */
   searchDiscourseNodesByTitle = async (
     query: string,