Anatomy of a research note

Give the reader context

A note has a descriptive title, date, category, summary, and estimated reading time. Demonstration entries also carry a visible synthetic label on the index and the article itself.

Use a repeatable structure

Begin with a question and explain where the example comes from. Distinguish direct observations from interpretations. Close with limitations and a bounded next question.

• Context and research question
• Source and explicitly labeled synthetic fixture
• Interpretation with assumptions stated
• Limitations and next questions

Treat code as a readable example

Code blocks are inert text rendered by React. There is no embedded code execution, remote notebook, or visitor-submitted markup.

// Synthetic example; no requests are made.
const observation = {
  source: "synthetic",
  scope: "local fixture",
};

Review before publishing

Check links, accessibility, unsupported claims, licensing, and accidental sensitive information. A note's technical formatting should make its limitations easier to see, not make it appear more authoritative than the evidence supports.