diff --git a/.gitignore b/.gitignore index e24c2d3d4..bf052d4a8 100644 --- a/.gitignore +++ b/.gitignore @@ -42,3 +42,4 @@ apps/tldraw-sync-worker/tsconfig.tsbuildinfo apps/tldraw-sync-worker/.wrangler/* .claude/* CLAUDE.md +*:Zone.Identifier diff --git a/apps/website/content/obsidian/fundamentals/mapping-claims-and-evidence.md b/apps/website/content/obsidian/fundamentals/mapping-claims-and-evidence.md new file mode 100644 index 000000000..83810278b --- /dev/null +++ b/apps/website/content/obsidian/fundamentals/mapping-claims-and-evidence.md @@ -0,0 +1,47 @@ +--- +title: "Mapping claims and evidence" +date: "2026-07-23" +author: "" +published: true +--- + +## Building an argument + +**Discourse Relations** (_i.e._ supports, informs, opposes) are a means of illustrating the relationships between different discourse nodes related to your animating Question. We can use discourse relations to wire together claims and evidence from a single source, or (perhaps more interestingly) to connect evidence from multiple sources that is relevant to a claim or group of claims. + +![Mapping claims and evidence](/docs/obsidian/claim-mapping01.png) +_Different claims my be supported or opposed by evidence from different sources_ + +In the image above, a single article provides two different pieces of evidence _supporting_ a particular claim, while an experiment and a simulation result both _oppose_ a second claim. A third source provides both supporting and opposing evidence for a third claim. + +Such a constellation of conflicting claims and evidence is relatively uncommon within a single article (excluding meta-analyses), where claims and evidence share a single author, but very common when sources are intermingled. + +The discourse graph breaks the interpretive frame imposed by the article. Working across analytical boundaries in this way makes the thoughtful use of _relations_ paramount: once freed from the inferential structure of their source material, claims and evidence require solid grounding to be fruitfully integrated into your graph. This includes accurately linking evidence to the relevant claim, evaluating the strength of the evidence (independent of its valence), and often taking a closer look at the method that produced the evidence to assess whether a replication or different approach is warranted. + +![evaluating sources](/docs/obsidian/grounding-evd.png) +_Linking evidence to claims, assigning weights to evidence, assessing sources_ + +## Orienting your map + +Relations carry semantic information about the relationship of different nodes to each other, but they also help to orient your graph in conceptual space. + +### Spotting gaps in methodology + +A researcher clustering sources by methodology, for instance, might find that conflicting support for a particular claim could potentially be resolved by using a method from a more distant conceptual space. + +![evidence clustering suggests novel method](<../../../public/docs/obsidian/evidence gap-selection02.png>) +_Mind the gap: there are ideas for different experiments to be found within_ + +### Finding unsynthesized claims + +Similarly, a researcher performing a literature synthesis might find that certain extracted claims require more substantiation -- either by revisiting the literature to make sure all of the authors' evidence has been captured, or designing a new study. + +![spotting gaps in your evidence map](/docs/obsidian/gap-spotting.png) +_Gap spotting in a literature synthesis_ + +### Gathering your party and venturing forth + +Just as a map without roads would lack important information about the best routes to places of interest, a discourse graph without relations leaves out important information about which scientific roads are well-traveled -- and which less-traveled paths might lead to treasure. + +![choose your own adventure](/docs/obsidian/quest-map.png) +_There is no fast travel in science ..._ diff --git a/apps/website/public/docs/obsidian/claim-mapping01.png b/apps/website/public/docs/obsidian/claim-mapping01.png new file mode 100644 index 000000000..6d35c358c Binary files /dev/null and b/apps/website/public/docs/obsidian/claim-mapping01.png differ diff --git a/apps/website/public/docs/obsidian/evidence gap-01.png b/apps/website/public/docs/obsidian/evidence gap-01.png new file mode 100644 index 000000000..b9ce412d1 Binary files /dev/null and b/apps/website/public/docs/obsidian/evidence gap-01.png differ diff --git a/apps/website/public/docs/obsidian/evidence gap-selection.png b/apps/website/public/docs/obsidian/evidence gap-selection.png new file mode 100644 index 000000000..e5d1fb39b Binary files /dev/null and b/apps/website/public/docs/obsidian/evidence gap-selection.png differ diff --git a/apps/website/public/docs/obsidian/evidence gap-selection02.png b/apps/website/public/docs/obsidian/evidence gap-selection02.png new file mode 100644 index 000000000..a50a5a524 Binary files /dev/null and b/apps/website/public/docs/obsidian/evidence gap-selection02.png differ diff --git a/apps/website/public/docs/obsidian/grounding-evd.png b/apps/website/public/docs/obsidian/grounding-evd.png new file mode 100644 index 000000000..bb8bdb6db Binary files /dev/null and b/apps/website/public/docs/obsidian/grounding-evd.png differ diff --git a/apps/website/public/docs/obsidian/quest-map.png b/apps/website/public/docs/obsidian/quest-map.png new file mode 100644 index 000000000..e704b5fa4 Binary files /dev/null and b/apps/website/public/docs/obsidian/quest-map.png differ