Code examples use real imports and are runnable

Non-runnable code examples are an AI-slop hallmark: imports that point at fictitious packages, function names that never existed, parameter signatures that drifted two versions ago. When a developer pastes your example and it throws Module not found or TypeError: x is not a function, they lose trust in every other claim in your docs. This is a reference-integrity defect that wastes evaluator time and signals an unmaintained project, tanking adoption and inviting support tickets for problems your docs created.

Replace placeholder imports like from 'your-package' with the actual published package name, verify every function and parameter name against the current source, and run each example in a scratch file before committing. A simple validator:

node -e "const { createClient } = require('your-actual-package'); console.log(typeof createClient)"

If the import throws, the example is wrong. Wire a docs-test CI job against docs/**/*.md to catch drift before it ships.