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
  • Popover
  • Discourse score
  1. Guides
  2. Exploring your discourse graph

Discourse context overlay

PreviousDiscourse contextNextDiscourse attributes

Last updated 2 years ago

The discourse context overlay adds an icon next to each discourse node wherever it is referenced. This icon provides access to two key features: 1) a popover to view the Discourse context of the node inline, and 2) a "discourse score" component that displays a customizable score for the node that is some function of its relations to other nodes in the discourse graph.

The overlay is an optional feature that is turned off by default. To turn it on, go to the grammar tab in the config page and check the box for overlay.

Popover

The popover is simple to operate. Simply click on the icon to bring up the component in-line for quick reference.

Discourse score

By default, the discourse score displays the count of the total number of discourse relations for that node (the number on the left), as well as a count of the total number of references to that node in the graph.

You can think of this default discourse score as a rough sense of how "robust" a given node is (discourse relations are more structured, high-signal relationships) relative to how "important" it is (raw references are often noisy). If you'd like, you can also experiment with different functions of discourse relations to a node by defining your own Discourse attributes, and have them show up in the overlay!

Slightly old video demo:

For example, the following score display denotes that the node participates in 5 discourse relations with other nodes, which can be seen in detail in the discourse context popover (1 informs, 1 supports, 2 consistent with, and 1 sourced by; note that 2 of these relations are ).

πŸ—ΊοΈ
custom relations
discourse context