RoamResearch Discourse Graph Extension
  • 🏠Welcome!
  • 👷‍♀️Installation
  • 🗺️Guides
    • Creating discourse nodes
    • Creating discourse relationships
    • Exploring your discourse graph
      • Discourse context
      • Discourse context overlay
      • Discourse attributes
      • Node index
    • Querying your discourse graph
    • Extending and personalizing your discourse graph
    • Sharing your discourse graph
  • 🧱Fundamentals
    • What is a Discourse Graph?
    • The Base Grammar: Questions, Claims, and Evidence
    • The Discourse Graph Extension Grammar
      • Nodes
      • Operators and relations
      • Relation patterns
      • Specifying context for discourse relations
    • Graph Querying
  • 🚢Use Cases
    • Individual literature reviewing
    • Enhanced zettelkasten
    • Enhanced reading clubs/seminars
    • Open-science-ready lab notebooks
    • Grounded product / research roadmapping
  • Extras
    • Experimental features
      • Playground
    • Keyboard Shortcuts
    • CSS
  • Meta
    • 🔬This is research software!
    • 🚀Changelog
    • 🙋Getting support
Powered by GitBook
On this page
  • Basic "stock" patterns
  • Question informed by Evidence
  • Claim supported by Evidence
  • Claim opposed by Evidence
  • Digging deeper
  1. Guides

Creating discourse relationships

PreviousCreating discourse nodesNextExploring your discourse graph

Last updated 3 years ago

You can create formal discourse relations between nodes by writing and outlining!

The extension has an in-built that enables it to recognize when certain patterns of writing and outlining are meant to express particular discourse relations (e.g., support, oppose, inform) between discourse nodes. When it recognizes these patterns, it "writes" them to a formal discourse graph data structure, that you can then use to explore or query your discourse graph.

Basic "stock" patterns

The extension ships with the ability to recognize three such writing/outlining patterns. Give them a try!

Question informed by Evidence

Go into a question page.

Create a block, and reference an evidence page.

Like this:

The system now formally recognizes that this piece of evidence informs the question (and equivalently, the question is informed by that evidence)!

Claim supported by Evidence

Create a block anywhere, and reference a claim page. We'll call this the claim block.

Indent a block underneath the claim block. And reference the page [[SupportedBy]]. We'll call this the connecting block.

Indent a block underneath the connecting block. And reference an evidence page.

Like this:

The system now formally recognizes that this piece of evidence supports that claim (and equivalently, the claim is supported by that evidence)!

Claim opposed by Evidence

Create a block anywhere, and reference a claim page. We'll call this the claim block.

Indent a block underneath the claim block. And reference the page [[OpposedBy]]. We'll call this the connecting block.

Indent a block underneath the connecting block. And reference an evidence page.

Like this:

The system now formally recognizes that this piece of evidence opposes that claim (and equivalently, the claim is opposed by that evidence)!

Digging deeper

You can verify this by checking the of the question or the evidence page.

Or by running a for evidence that informs that question.

You can verify this by checking the of the claim or the evidence page.

Or by running a for evidence that supports that claim.

You can verify this by checking the of the claim or the evidence page.

Or by running a for evidence that supports that claim

Want to recognize other patterns that aren't listed here? Or don't like these? You can ! But you might first want to .

🗺️
discourse context
query
discourse context
query
discourse context
query
change them
understand how the grammar works
grammar