Manual
The document
OverviewGrammarDocument headerSyntax cheatsheet Scene Step
Content
Text blocks
Paragraph Heading 1 Heading 2 Heading 3 Heading 4 List
Maths
Equation Maths
Tables & images
Table Image
Formatting
Bold Italics Inline Code Highlight
Text colours
Links & references
Link Footnote Icon Internote Reference
ValueWhere inline content works
Narrative only
Note Definition Example Task Divider
Graph pane
Graph
Curves & areas
Curve Integral
Data marks
Scatter Histogram
Fits
Fit Residuals
Surfaces
Contour Heatmap
Marks
Line Segment Vector Point Polygon Text
Shapes
Circle Square Rectangle Triangle Star Diamond Hexagon
Axis furniture
Axis label Axis Brace
Expressions
Code pane
Code Lines
Animation & interaction
Cues that wrap content
Cue Draw cue Trace cue Highlight cue Spotlight cue Type cue
Cues on a value
Value cue Zoom cue
Anchors & timing Parameter
Advanced features
Data Let Define Preset Include If For Ignore
Reference
All constructs A–ZAttribute types
Concepts
IdentifiersBody & detailDerived attributes
Guidance
The narrative contractWhat earns a place on the canvasParameter or cueHonest numbersCode demonstrates, never computesAuthor-attached data only
?
  1. Reference
  2. Guidance
  3. Author-attached data only

Author-attached data only

A canvas shows data its author has seen. Reader-supplied data arrives by forking, with authorship attached.

#The rule

A canvas shows data its author has seen. Reader-uploaded data never enters a published internote — this is decided, not deferred.

Data reaches a document through @data, inline or attached as a CSV, and both forms are written by the author into the source.

#Why reader uploads are ruled out

An internote whose canvas shows data the author never saw has no author. The prose cannot make a claim about it, so it collapses into generic captioning — your data may show…, notice any outliers… — which is the narrative contract failing in its purest form. The feature would produce documents that look interactive and say nothing.

It is the same reasoning as the range rule: an author can narrate a range they chose. They cannot narrate data they have never seen.

#The fork is the path

Reader data is not impossible in the medium — it arrives with authorship attached. Fork the document, swap the @data declaration for your own, and rewrite the narrative you now owe. The result has an author again: you.

#What this asks of you

  • Look at the data before you write about it. The claims in the prose are claims about these rows.
  • Attach the real thing rather than a rounded excerpt, so a reader checking the numbers finds them.
  • Transform upstream. @data has no computed columns, filters or aggregates by design — what the document reads is what the file says.
On this page
The ruleWhy reader uploads are ruled outThe fork is the pathWhat this asks of you
PrivacyTermsContact Support
Author-attached data only · Internote