Docs & technical writing
AuraScore 83/100

Product Documentation Marketing Alignment Matrix

Audit product documentation against marketing conversion claims to eliminate messaging discrepancies.

Use this template when marketing campaign messaging drifts away from actual technical documentation and developer guides. It produces a gap matrix to align technical reality with top-of-funnel copywriting.

Template

Role: Senior Technical Marketing Documentation Architect specializing in commercial messaging fidelity.

Context

  • Organization Name: {{company_name}}
  • Target Product Tier: {{product_tier}}
  • Promoted Marketing Claims: {{promoted_marketing_claims}}
  • Current Documentation Corpus: {{existing_documentation_corpus}}
  • Customer Conversion Stage: {{customer_conversion_stage}}
  • Strategic Growth Pillar: {{strategic_growth_pillar}}

Task

Conduct a rigorous messaging audit comparing public technical documentation against marketing claims, producing an actionable alignment matrix that resolves discrepancies and protects customer trust.

Method

  1. Analyze the promotional promises outlined in {{promoted_marketing_claims}} against {{strategic_growth_pillar}}.
  2. Review {{existing_documentation_corpus}} to verify whether technical docs support each published claim.
  3. Classify discrepancy levels across onboarding friction, missing API parameters, or exaggerated feature readiness.
  4. Evaluate how messaging drift affects user drop-off at {{customer_conversion_stage}} for {{product_tier}}.
  5. Author recommended documentation revisions that validate commercial marketing claims.
  6. Author corresponding marketing copy refinements where technical capabilities require caveats or precision.
  7. Assign impact ratings to prioritize high-risk gaps for {{company_name}}'s technical writers.

Constraints

  • MUST generate the core audit as a comprehensive markdown matrix.
  • MUST NOT soften or dismiss discrepancies between product docs and marketing promises.
  • Recommendations MUST provide concrete copy edits for both technical docs and marketing assets.
  • Tone MUST remain analytical, objective, and solution-focused.

Output format

1. Messaging Fidelity Executive Summary

Brief assessment of documentation consistency and brand risk (120-180 words).

2. Marketing vs. Documentation Alignment Matrix

A markdown table with 6 columns: Marketing Claim, Documentation Reality, Alignment Status (Aligned / Partial / Drift), Risk Severity, Doc Revision Required, and Marketing Copy Adjustment.

3. Immediate Action Priority Table

A 3-item list ranking the highest-risk alignment fixes with designated owners.

Self-review

  • Are all claims from {{promoted_marketing_claims}} audited in the matrix?
  • Does each row provide specific remediation text rather than general advice?
  • Is the analysis tailored specifically to {{customer_conversion_stage}}?
AuraScore breakdown
83/100Provisional
Instruction clarity15/15 · Strong

Explicit role, a named task, and discrete steps the model can follow.

Context architecture12/12 · Strong

Background, inputs and variables the model needs before it starts.

Constraint engineering12/12 · Strong

Hard boundaries — what the model must and must not do.

Output specification6/14 · Thin

A named, field-level shape for the response.

Reasoning structure10/10 · Strong

Ordered work items that force analysis before an answer.

Model compatibility10/10 · Strong

Length and structure that travel across frontier models.

Token efficiency7/10 · Adequate

Signal density — instruction weight without padding.

Reusability7/7 · Strong

Documented variables so the scaffold adapts to new inputs.

Robustness3/5 · Adequate

Quality bar, assumptions and behaviour when inputs are thin.

Observed performance1/5 · Thin

How much real usage the template has behind it.

writing-content
writing-docs
business-strategy-marketing-sales
documentation-audit
copywriting-alignment
marketing-ops