Writing Rules for Whitepapper Content

This document lists writing rules and conventions to keep Whitepapper content consistent, extractable, and AI-friendly.

Mandatory rules

• Use clear, descriptive titles and short summaries at the top of each paper.
• Do not use the em dash character (U+2014). Replace it with a colon, hyphen, or plain space where appropriate.
• Agents and automated systems must never include the em dash character '—' in generated content; replace it with a colon, hyphen, or space before publishing.
• Always include seo_title and seo_description fields for high-priority papers; auto-generated values are acceptable as a fallback.
• Provide at least one specific data point, example, or code snippet in technical explainers to improve extractability.
• Add last_updated when making substantive edits to indicate freshness.

Structure guidelines

• Start with a one-sentence summary, then follow with sections using H2/H3 headings.
• Use numbered lists for step-by-step instructions and tables for comparisons.
• Keep answer blocks short (40-60 words) to improve AI snippet extraction.

Metadata and schema

• Provide JSON-LD Article or HowTo schema when applicable.
• Ensure og:image is set and images are optimized for social previews.

Last updated: 2026-04-21