Inferensys

Prompts

Developer Documentation QA and Review

Prompt playbooks for auditing existing documentation for accuracy, completeness, consistency, and adherence to style guides. Useful for technical writing teams and doc platform engineers because QA prompts must flag broken links, stale code samples, missing parameters, contradictory instructions, and accessibility gaps before publication.
Developer reviewing semantic search engine results on laptop, relevance scores visible, technical search demo.
Prompts

Developer Documentation QA and Review

Prompt playbooks for auditing existing documentation for accuracy, completeness, consistency, and adherence to style guides. Useful for technical writing teams and doc platform engineers because QA prompts must flag broken links, stale code samples, missing parameters, contradictory instructions, and accessibility gaps before publication.

API Reference Accuracy Audit Prompt Template

For technical writing teams validating API docs against live implementations. Produces a structured audit report flagging parameter mismatches, missing endpoints, incorrect types, and stale descriptions. Includes harness for diffing doc claims against OpenAPI specs or runtime behavior.

Endpoint Parameter Completeness Check Prompt

For API platform engineers ensuring every query, path, header, and body parameter is documented. Produces a completeness matrix with required/optional flags, default values, valid ranges, and deprecation status. Includes eval checks for missing or undocumented parameters.

Request/Response Schema Validation Prompt

For doc platform engineers verifying documented schemas match actual API behavior. Produces a field-by-field comparison report identifying type mismatches, missing fields, incorrect constraints, and example payload errors. Harness includes JSON Schema or OpenAPI validation integration.

Broken Link Detection Prompt for Documentation Sites

For doc site maintainers auditing internal and external links across documentation pages. Produces a categorized link report with HTTP status codes, redirect chains, anchor validity, and suggested replacements. Includes evaluation criteria for false positives from authenticated endpoints.

Stale Code Sample Identification Prompt

For DevRel and documentation engineers detecting code examples that no longer compile or use deprecated APIs. Produces a sample-by-sample audit with version compatibility notes, syntax errors, and replacement suggestions. Harness requires language-specific compilation or linting validation.

Missing Error Code Documentation Audit Prompt

For support engineers and API consumers ensuring every possible error response is documented. Produces a gap analysis mapping observed error codes to documentation coverage, with severity classification and remediation guidance completeness scores.

Authentication Flow Documentation Accuracy Review Prompt

For security engineers validating OAuth, API key, and token documentation against actual auth behavior. Produces a step-by-step accuracy report checking grant types, scope requirements, token lifetimes, refresh patterns, and error responses. Includes harness for automated auth flow testing.

Style Guide Adherence Audit Prompt

For technical writing leads ensuring documentation follows internal style guides. Produces a violation report covering terminology, formatting, voice, code formatting, and structural conventions. Includes configurable rule sets and severity thresholds.

Configuration Parameter Default Value Audit Prompt

For platform and DevOps engineers verifying documented default values match actual behavior. Produces a parameter-by-parameter audit flagging incorrect defaults, missing required flags, undocumented environment variables, and stale deprecation warnings.

OpenAPI Spec-to-Documentation Consistency Prompt

For API designers ensuring human-readable documentation stays synchronized with the OpenAPI specification. Produces a diff report comparing endpoint descriptions, parameter tables, schema definitions, and example payloads against the source spec.

Code Snippet Security Anti-Pattern Detection Prompt

For security engineers reviewing documentation code examples for vulnerabilities. Produces a security audit flagging hardcoded credentials, missing input validation, insecure defaults, exposed secrets, and outdated cryptographic practices in documented code samples.

Rate Limiting Documentation Accuracy Review Prompt

For API product managers validating that documented rate limits, headers, and retry guidance match actual API behavior. Produces a compliance report comparing documented limits against observed response headers, status codes, and window semantics.