FEE 871 Mapping claims and evidence - #1247
Conversation
KarolaKirsanow
added
the
documentation
|
@KarolaKirsanow is attempting to deploy a commit to the Discourse Graphs Team on Vercel. A member of the Team first needs to authorize it. |
PR size/scope checkThis PR is over our review-size guideline.
Please split this into smaller PRs unless there is a clear reason the changes need to land together. If keeping it as one PR, please add a brief justification covering:
|
![devin-ai-integration[bot]](https://avatars.githubusercontent.com/in/811515?s=60&v=4){kind=small}
| --- | ||
| title: "Mapping claims and evidence" | ||
| date: "2026-07-23" | ||
| author: "" | ||
| published: true | ||
| --- |
There was a problem hiding this comment.
🟡 New documentation page uses the wrong file extension for a plain-text article
The new article is saved as an MDX file (apps/website/content/obsidian/fundamentals/mapping-claims-and-evidence.mdx) even though it contains only plain prose and images, while the project's documentation rules reserve MDX for pages that use components.
Impact: The page deviates from the documented file-naming convention for docs, making the content tree inconsistent.
Convention source and file contents
skills/update-user-docs/references/doc-conventions.md states: "Use .md for normal prose pages and .mdx only when the page needs components." The new page contains only headings, paragraphs and image links — no NodeTag, Callout, or other MDX components — so it should be mapping-claims-and-evidence.md, with the _meta.ts slug unchanged (apps/website/content/obsidian/fundamentals/_meta.ts:6). Note the sibling prose page in the same directory is base-grammar.md.
Prompt for agents
The new docs page apps/website/content/obsidian/fundamentals/mapping-claims-and-evidence.mdx contains only prose and image links, with no MDX components. Repository docs conventions (skills/update-user-docs/references/doc-conventions.md) require .md for prose pages and .mdx only when components are used; the sibling page base-grammar.md follows this. Rename the file to .md; the _meta.ts entry uses the slug so it needs no change.
Was this helpful? React with 👍 or 👎 to provide feedback.
![graphite-app[bot]](https://avatars.githubusercontent.com/in/158384?s=60&v=4){kind=small}
|
request a read from @joelchan and/or @jsmorabito for content. |
jsmorabito
left a comment
jsmorabito
left a comment
There was a problem hiding this comment.
Looks great!! Approved 👍
2 participants
This adds a short article to obsidian/fundamentals called "Mapping claims and evidence" as suggested by our SEO analysis. The article can be copied to roam/fundamentals; it has no platform-specific content