Skip to main content
Eric Disque. Back
Work Sample · Evaluation Rubric

GenAI Content
Governance.

Generative AI accelerates content production, but speed without governance creates technical debt. This rubric is the architectural guardrail for all LLM-generated documentation — ensuring automated output meets enterprise standards for accuracy, brand alignment, and structural integrity before it reaches the deployment pipeline.

Scoring methodology — A binary validation system. A piece of generated content must pass every critical check, in all four dimensions, to be approved for deployment.

Dimension 01

Technical & Architectural Integrity

Factually flawless and structurally sound.

  • Code Validity
    All generated code snippets, JSON payloads, and CLI commands compile, run, and validate against the current API version.
  • Feature Accuracy
    Text describes the product's actual capabilities, not hallucinated features.
  • Prerequisite Clarity
    The content explicitly states all necessary dependencies, permissions, and environmental setup before instructions begin.
Dimension 02

Structural & Formatting Compliance

Strict docs-as-code hygiene.

  • Markdown Hygiene
    Clean, standard Markdown — no injected HTML or broken rendering tags.
  • Information Hierarchy
    Logical flow (H1 title, H2 major sections, H3 sub-steps) with no skipped heading levels.
  • Modularity
    Content breaks into smaller, reusable components that plug into the larger ecosystem.
Dimension 03

Brand Voice & Semantic Alignment

Sounds like the brand, not a generic LLM.

  • Fluff Elimination
    Aggressively cut standard AI filler ("In conclusion," "It is important to note," "Delve," "Transformative").
  • Active Voice
    Imperative mood and active voice ("Click the button" — not "The button should be clicked").
  • Density
    High information density. Every sentence serves a functional purpose.
Dimension 04

Inclusivity & Accessibility

Usable by a global, diverse engineering audience.

  • Plain Language
    Simple, direct vocabulary — no unnecessary idioms, jargon, or regional metaphors.
  • Inclusive Terminology
    Scrubbed of legacy exclusionary terms (use "allowlist/blocklist", not "whitelist/blacklist").
  • Visual Accessibility
    All generated tables have clear headers; all suggested images include descriptive alt text.
Back to home