Makegood

Master this essential documentation concept

Quick Definition

Compensation offered to advertisers for missed or disrupted ad placements during broadcast incidents, typically in the form of free ad spots.

How Makegood Works

graph TD A[Service Delivery Initiated] --> B{Documentation Meets SLA?} B -->|Yes| C[Service Complete] B -->|No| D[Service Failure Identified] D --> E[Assess Impact & Scope] E --> F[Determine Makegood Compensation] F --> G{Compensation Type} G -->|Additional Content| H[Create Supplementary Docs] G -->|Extended Support| I[Provide Extended Access] G -->|Expedited Updates| J[Prioritize Revisions] H --> K[Deliver Makegood] I --> K J --> K K --> L[Document & Track] L --> M[Client Satisfaction Restored] M --> N[Implement Process Improvements]

Understanding Makegood

Makegood represents a quality assurance and client retention mechanism that documentation teams use to address service failures or unmet expectations. When documentation deliverables miss deadlines, contain significant errors, or fail to provide adequate coverage, makegood compensation helps restore client trust and satisfaction.

Key Features

  • Compensation in the form of additional documentation resources or extended support
  • Typically offered without additional cost to the affected client
  • Can include expedited updates, supplementary guides, or training sessions
  • Documented through formal agreements or service level terms
  • Tracked and reported for quality improvement purposes

Benefits for Documentation Teams

  • Strengthens client relationships by demonstrating accountability
  • Provides leverage for continuous improvement initiatives
  • Creates financial incentives for meeting delivery commitments
  • Generates valuable feedback about documentation gaps
  • Reduces churn and increases long-term client retention

Common Misconceptions

  • Makegood is not a penalty but a remedial service offering
  • It doesn't replace proper quality assurance processes
  • Makegood compensation should be proportionate to the service failure
  • It requires clear SLA definitions to be effective

Real-World Documentation Use Cases

Missed Documentation Deadline Recovery

Problem

A documentation team fails to deliver API documentation by the agreed release date, delaying client product launch by one week

Solution

Offer makegood compensation through expedited creation of supplementary quick-start guides and video tutorials at no additional cost

Implementation

['Identify the specific documentation gap caused by the delay', 'Calculate equivalent value of makegood compensation', 'Assign dedicated resources to create supplementary materials within 48 hours', 'Deliver makegood content with priority support for 30 days', 'Document the incident and resolution in quality tracking system']

Expected Outcome

Client receives additional valuable resources, deadline impact is mitigated, and relationship is preserved with documented commitment to improvement

Incomplete Feature Documentation

Problem

Released documentation omits critical features or use cases, requiring clients to contact support repeatedly for clarification

Solution

Provide makegood compensation through comprehensive documentation updates and extended access to documentation specialists for consultation

Implementation

['Conduct audit to identify all missing feature documentation', 'Create detailed addendum covering gaps within one week', 'Offer 90 days of priority support from documentation team', 'Develop interactive examples or code samples for complex features', 'Establish feedback mechanism for continuous improvement']

Expected Outcome

Documentation becomes comprehensive and usable, client satisfaction increases, and documentation team gains insights for preventing similar gaps

Quality Issues in Translated Documentation

Problem

Translated documentation contains errors and inconsistencies that confuse international users and damage product credibility

Solution

Offer makegood through professional review and correction of all translated materials plus creation of glossaries and style guides

Implementation

['Engage native speakers to audit translated content', 'Prioritize correction of highest-impact errors', 'Create comprehensive terminology glossaries for future translations', 'Develop translation style guide specific to product domain', 'Provide free translation quality assurance for next release cycle']

Expected Outcome

Translation quality improves significantly, international users gain confidence in documentation, and future translation projects have clear standards

Outdated Documentation During Rapid Updates

Problem

Product updates occur faster than documentation team can update guides, leaving users with obsolete information and high support burden

Solution

Provide makegood through creation of interim release notes, video updates, and extended documentation support period

Implementation

['Establish rapid documentation update process for critical changes', 'Create weekly video summaries of changes during high-velocity periods', 'Offer extended live chat support for documentation questions', 'Develop searchable changelog with implementation examples', 'Provide free documentation audit for next product cycle']

Expected Outcome

Users stay informed despite rapid changes, support tickets decrease, and documentation team gains process improvements for handling velocity

Best Practices

✓ Define Clear SLA Metrics for Makegood Triggers

Establish explicit, measurable service level agreements that clearly define what constitutes a documentation failure and triggers makegood compensation. Include specific metrics for timeliness, completeness, accuracy, and usability.

✓ Do: Create detailed SLA documentation specifying delivery dates, content completeness percentages, error thresholds, and response times. Include examples of each makegood trigger level.
✗ Don't: Avoid vague language like 'timely' or 'adequate' without numerical definitions. Don't create SLAs that are impossible to measure or track.

✓ Proportionately Match Compensation to Service Impact

Ensure makegood compensation is appropriate to the severity and scope of the service failure. Over-compensation creates unsustainable precedent while under-compensation damages trust.

✓ Do: Create a compensation matrix correlating failure types and severity levels to specific makegood offerings. Document rationale for each tier.
✗ Don't: Avoid offering identical compensation for minor and major failures. Don't make compensation decisions based on client pressure rather than objective impact assessment.

✓ Track and Analyze Makegood Patterns

Maintain detailed records of all makegood instances to identify systemic issues, recurring problems, and process improvement opportunities. Use this data to prevent future failures.

✓ Do: Create a makegood tracking database with failure type, cause, compensation offered, and resolution. Conduct quarterly analysis to identify trends and root causes.
✗ Don't: Avoid treating makegood as isolated incidents. Don't fail to investigate root causes or implement preventive measures based on patterns.

✓ Communicate Makegood Decisions Transparently

When offering makegood compensation, clearly explain the failure, the impact, and why specific compensation was chosen. This builds trust and demonstrates accountability.

✓ Do: Send detailed communication outlining the issue, its impact on the client, the makegood offer, and timeline for delivery. Include action items to prevent recurrence.
✗ Don't: Avoid offering makegood without explanation. Don't make clients feel like compensation is grudging or inadequate.

✓ Deliver Makegood Compensation with Excellence

Treat makegood deliverables with the same or higher quality standards than regular work. Poor quality makegood damages credibility more than the original failure.

✓ Do: Assign your best resources to makegood projects. Include quality review, testing, and client feedback cycles. Set aggressive timelines for delivery.
✗ Don't: Avoid treating makegood as low-priority work. Don't deliver makegood content with quality issues or delays. Don't fail to follow up on client satisfaction with makegood.

How Docsie Helps with Makegood

Book a Demo

Build Better Documentation with Docsie

Join thousands of teams creating outstanding documentation

Book a Demo