Points
A Point is content you identify for independent discussion. It can be a question, sentence, fragment or passage. Use a mark to say how you are presenting it here:
| Mark | Name | Use here |
|---|---|---|
[Q] |
Question | A question or issue to examine |
[C] |
Claim | A claim, position or possible answer |
[G] |
Ground | A reason for another Point |
[O] |
Objection | An objection or opposing explanation |
[R] |
Response | A response to another Point |
[D] |
Distinction | A distinction that helps clarify another Point |
[.] |
Neutral Point | Content without a specified role |
A role describes this presentation, rather than a permanent type or a judgment of truth. The same content can be a Claim in one discussion and a Ground in another. A response may also answer or clarify something; its mark need not catalogue everything the passage does.
Keep the complete content
- [C] The method may work
under the same calibration conditions.
- [G] Both runs used the same temperature.
The Claim includes its continuation line. Keep qualifications in the content even when Map shortens the display. A Point need not be a complete declarative sentence, and a new line does not turn its continuation into a note.
Ordinary context can stay unmarked. It remains in Reading without becoming another Point.
Questions do not prescribe their children
- [Q @scale] How fast is "fast" here?
- [.] Seconds, rather than minutes.
- [C] The record does not describe the measurement method.
All three are complete Points. The nesting organizes the discussion without automatically recording an answer or relevance relation. A neutral Point leaves its role unspecified; it need not be impartial or unfinished.
When you want to record an answer explicitly:
- [Q @scale] How fast is "fast" here?
- [. answers @scale] Seconds, rather than minutes.
[R] beneath the Question instead records a response.
Neither a response nor an answer relation certifies that the question is resolved.
See connections from indentation for the other local relations.
Name a Point for later reference
- [C @claim] The current explanation is incomplete.
- [G] It does not account for the second observation.
- [O -> @claim] That observation may be a measurement error.
@claim names the Claim.
The anonymous Ground and Objection remain full Points.
Names use lowercase letters, digits, hyphens or underscores, beginning with a letter.
Keep a name when later references should continue to identify the same content.
Reuse without copying
- [C @observation] Two retries timed out.
- [C @cause] A shared configuration fault may explain the failures.
- [G use @observation] Consider these retries in this step.
use presents the existing Point as a Ground here.
Its content and original declaration remain shared; this appearance adds its own supporting connection.
The words after the use are commentary at this appearance, rather than a replacement for “Two retries timed out.”
Use [. use @observation] to present the same Point without a default connection.
It does not copy the Point’s children or notes.
If you change what the claim says, declare a new Point instead.
Keep supplementary prose in a note
- [C] The measurements can be compared.
- [G] Both runs used the same calibration procedure.
- [note] Source: laboratory record, section 2.
- Check the archived worksheet before revising.
A note and its whole indented subtree remain supplementary prose. They add no Points or connections, even if a quoted line looks like an annotation. Keep a qualification that changes the Claim in its content; give a separate reason its own Point.
For alias spellings, object notes and precise reference boundaries, consult the syntax reference. The English / 繁體中文 glossary gives suggested Chinese readings.