Documentation Maintenance

{
  "id": "documentation-maintenance",
  "numericId": "E760",
  "path": "/internal/documentation-maintenance/",
  "filePath": "internal/documentation-maintenance.mdx",
  "title": "Documentation Maintenance",
  "quality": null,
  "readerImportance": 9.5,
  "researchImportance": 8.5,
  "tacticalValue": null,
  "contentFormat": "article",
  "tractability": null,
  "neglectedness": null,
  "uncertainty": null,
  "causalLevel": null,
  "lastUpdated": "2026-03-13",
  "dateCreated": "2026-02-20",
  "llmSummary": null,
  "description": "Guidelines for keeping internal documentation accurate and up-to-date",
  "ratings": null,
  "category": "internal",
  "subcategory": "style-guides",
  "clusters": [
    "ai-safety"
  ],
  "metrics": {
    "wordCount": 636,
    "tableCount": 4,
    "diagramCount": 0,
    "internalLinks": 14,
    "externalLinks": 0,
    "footnoteCount": 0,
    "bulletRatio": 0.32,
    "sectionCount": 26,
    "hasOverview": false,
    "structuralScore": 8
  },
  "suggestedQuality": 53,
  "updateFrequency": 60,
  "evergreen": true,
  "wordCount": 636,
  "unconvertedLinks": [],
  "unconvertedLinkCount": 0,
  "convertedLinkCount": 0,
  "backlinkCount": 1,
  "hallucinationRisk": {
    "level": "medium",
    "score": 60,
    "factors": [
      "no-citations",
      "few-external-sources"
    ]
  },
  "entityType": "internal",
  "redundancy": {
    "maxSimilarity": 10,
    "similarPages": [
      {
        "id": "page-types",
        "title": "Page Type System",
        "path": "/internal/page-types/",
        "similarity": 10
      }
    ]
  },
  "changeHistory": [
    {
      "date": "2026-02-17",
      "branch": "claude/wiki-generation-architecture-0J97Q",
      "title": "Route internal pages through /wiki/E<id>",
      "summary": "Migrated internal pages from `/internal/` to `/wiki/E<id>` URLs so they render with full wiki infrastructure (breadcrumbs, metadata, quality indicators, sidebar). Internal MDX pages now redirect from `/internal/slug` to `/wiki/E<id>`, while React dashboard pages (suggested-pages, updates, page-changes, etc.) remain at `/internal/`. Follow-up review: cleaned up dead code, hid wiki-specific UI on internal pages, fixed breadcrumbs, updated all bare-text `/internal/` references.",
      "pr": 182
    },
    {
      "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": 4,
    "total": 13,
    "targets": {
      "tables": 3,
      "diagrams": 0,
      "internalLinks": 5,
      "externalLinks": 3,
      "footnotes": 2,
      "references": 2
    },
    "actuals": {
      "tables": 4,
      "diagrams": 0,
      "internalLinks": 14,
      "externalLinks": 0,
      "footnotes": 0,
      "references": 0,
      "quotesWithQuotes": 0,
      "quotesTotal": 0,
      "accuracyChecked": 0,
      "accuracyTotal": 0
    },
    "items": {
      "llmSummary": "red",
      "schedule": "green",
      "entity": "red",
      "editHistory": "green",
      "overview": "red",
      "tables": "green",
      "diagrams": "red",
      "internalLinks": "green",
      "externalLinks": "red",
      "footnotes": "red",
      "references": "red",
      "quotes": "red",
      "accuracy": "red"
    },
    "editHistoryCount": 3
  },
  "readerRank": 596,
  "researchRank": 565,
  "recommendedScore": 25.91
}

No external links