DocsTones recordEdit on GitHub

Technical

Lead with the question or claim, then walk through the mechanism and the numbers. Use exact terminology; assume the audience can handle and prefers it. Diagrams, tables, and benchmarks are first-class.

Metadata

technical

Catalog

tones

Source

spec/catalogs/tones/technical.json

Field	Value
voiceCues	State the claim, then the mechanism, then the evidence., Use exact terminology — don't soften technical terms for general readability., Quote benchmarks with conditions (cold/warm, p50/p95/p99, dataset, hardware)., Prefer diagrams and tables over prose paragraphs for structural information.
avoid	Vague claims ('much faster', 'better', 'easier')., Marketing framing without supporting data., Glossing over caveats and tradeoffs., Casual register that obscures precision.
samplePhrases	p95 inference latency is 38ms on a single A100, down from 312ms on the prior runtime., We replaced the streaming serializer with a batched protobuf path; throughput rose 4.2× under load., The result holds for context windows up to 32k tokens; beyond that, see appendix B.
recommendedNarratives	challenge-resolution, innovation, conference-talk, engineering-update
tags	technical, engineering, research

Source JSON

technical.json

{
  "$schema": "https://openpresentation.org/schema/opf-tone/v1",
  "id": "technical",
  "name": "Technical",
  "summary": "Precise, evidence-led voice for engineering, research, and product-detail audiences.",
  "description": "Lead with the question or claim, then walk through the mechanism and the numbers. Use exact terminology; assume the audience can handle and prefers it. Diagrams, tables, and benchmarks are first-class.",
  "voiceCues": [
    "State the claim, then the mechanism, then the evidence.",
    "Use exact terminology — don't soften technical terms for general readability.",
    "Quote benchmarks with conditions (cold/warm, p50/p95/p99, dataset, hardware).",
    "Prefer diagrams and tables over prose paragraphs for structural information."
  ],
  "avoid": [
    "Vague claims ('much faster', 'better', 'easier').",
    "Marketing framing without supporting data.",
    "Glossing over caveats and tradeoffs.",
    "Casual register that obscures precision."
  ],
  "samplePhrases": [
    "p95 inference latency is 38ms on a single A100, down from 312ms on the prior runtime.",
    "We replaced the streaming serializer with a batched protobuf path; throughput rose 4.2× under load.",
    "The result holds for context windows up to 32k tokens; beyond that, see appendix B."
  ],
  "recommendedNarratives": [
    "challenge-resolution",
    "innovation",
    "conference-talk",
    "engineering-update"
  ],
  "tags": [
    "technical",
    "engineering",
    "research"
  ]
}