Common Writing Principles

{
  "id": "common-writing-principles",
  "numericId": "E726",
  "path": "/internal/common-writing-principles/",
  "filePath": "internal/common-writing-principles.md",
  "title": "Common Writing Principles",
  "quality": 0,
  "readerImportance": 73.5,
  "researchImportance": 71,
  "tacticalValue": null,
  "contentFormat": "article",
  "tractability": null,
  "neglectedness": null,
  "uncertainty": null,
  "causalLevel": null,
  "lastUpdated": "2026-03-13",
  "dateCreated": "2026-02-20",
  "llmSummary": "Shared writing principles referenced by all domain-specific style guides. Three pillars: epistemic honesty (hedge uncertain claims, use ranges, source confidence levels), language neutrality (avoid insider jargon, describe things by what they are), and analytical tone (present tradeoffs rather than prescribe). Includes concrete word substitution tables and anti-patterns.",
  "description": "Cross-cutting writing standards that apply to all content types. Covers epistemic honesty, language neutrality, and analytical tone.",
  "ratings": {
    "novelty": 3,
    "rigor": 5,
    "actionability": 7,
    "completeness": 6
  },
  "category": "internal",
  "subcategory": "style-guides",
  "clusters": [
    "ai-safety"
  ],
  "metrics": {
    "wordCount": 1562,
    "tableCount": 5,
    "diagramCount": 0,
    "internalLinks": 1,
    "externalLinks": 0,
    "footnoteCount": 2,
    "bulletRatio": 0.24,
    "sectionCount": 24,
    "hasOverview": false,
    "structuralScore": 10
  },
  "suggestedQuality": 67,
  "updateFrequency": 90,
  "evergreen": true,
  "wordCount": 1562,
  "unconvertedLinks": [],
  "unconvertedLinkCount": 0,
  "convertedLinkCount": 0,
  "backlinkCount": 4,
  "hallucinationRisk": {
    "level": "high",
    "score": 90,
    "factors": [
      "low-citation-density",
      "low-quality-score",
      "few-external-sources",
      "severe-truncation"
    ],
    "integrityIssues": [
      "severe-truncation"
    ]
  },
  "entityType": "internal",
  "redundancy": {
    "maxSimilarity": 11,
    "similarPages": [
      {
        "id": "citation-architecture",
        "title": "Citation Architecture: Current State & Unified Proposal",
        "path": "/internal/citation-architecture/",
        "similarity": 11
      },
      {
        "id": "coverage-guide",
        "title": "Page Coverage Guide",
        "path": "/internal/coverage-guide/",
        "similarity": 11
      },
      {
        "id": "models-style-guide",
        "title": "Models Style Guide",
        "path": "/internal/models-style-guide/",
        "similarity": 11
      },
      {
        "id": "models",
        "title": "Model Style Guide",
        "path": "/internal/models/",
        "similarity": 10
      },
      {
        "id": "risk-style-guide",
        "title": "Risk Pages Style Guide",
        "path": "/internal/risk-style-guide/",
        "similarity": 10
      }
    ]
  },
  "changeHistory": [
    {
      "date": "2026-02-17",
      "branch": "claude/add-page-info-boxes-7WxMd",
      "title": "Add PageStatus and info boxes to internal pages",
      "summary": "Enabled PageStatus rendering, Data links, and Feedback widgets on internal pages by removing the `isInternal` guards in the wiki page renderer. Added `evergreen`, `update_frequency`, and `lastEdited` frontmatter to all ~40 internal pages so update schedules and staleness indicators are visible.",
      "pr": 185
    },
    {
      "date": "2026-02-15",
      "branch": "claude/internal-pages-infrastructure-Y2TWq",
      "title": "Internal pages entity infrastructure",
      "summary": "Added full entity infrastructure to internal pages (style guides, architecture docs, research reports, schema docs). Internal pages now have the `internal` entity type, get auto-assigned E* numeric IDs (E698-E731), are included in the search index, and participate in backlinks/related graph computation. Includes review fixes: filtering internal pages from public explore/home, converting all 7 remaining .md files, adding `internal` to data/schema.ts, and updating all `shouldSkipValidation`/`pageType === 'documentation'` checks.",
      "pr": 142
    }
  ],
  "coverage": {
    "passing": 3,
    "total": 13,
    "targets": {
      "tables": 6,
      "diagrams": 1,
      "internalLinks": 12,
      "externalLinks": 8,
      "footnotes": 5,
      "references": 5
    },
    "actuals": {
      "tables": 5,
      "diagrams": 0,
      "internalLinks": 1,
      "externalLinks": 0,
      "footnotes": 2,
      "references": 0,
      "quotesWithQuotes": 0,
      "quotesTotal": 0,
      "accuracyChecked": 0,
      "accuracyTotal": 0
    },
    "items": {
      "llmSummary": "green",
      "schedule": "green",
      "entity": "red",
      "editHistory": "green",
      "overview": "red",
      "tables": "amber",
      "diagrams": "red",
      "internalLinks": "amber",
      "externalLinks": "red",
      "footnotes": "amber",
      "references": "red",
      "quotes": "red",
      "accuracy": "red"
    },
    "editHistoryCount": 2,
    "ratingsString": "N:3 R:5 A:7 C:6"
  },
  "readerRank": 133,
  "researchRank": 145,
  "recommendedScore": 58.3
}

No external links