# Content Validation Checklist

These are editorial preferences, not evidence of human or AI authorship. Apply only the requirements chosen by the author or project; other phrase and structure suggestions are advisory. Preserve quotations, code, literal terms, inventories, checklists, questionnaires, intentional punctuation, necessary uncertainty and domain terminology. A flagged phrase can be retained with a reason. Zero highlights and numeric scores are not publication gates. Never invent metrics, experiences, opinions or failures to satisfy a style marker.

## Pre-Writing Validation

- [ ] Have I read the actual source material (not just searched)?
- [ ] Do I have specific numbers, dates, and names?
- [ ] Am I clear on what actually happened vs. what sounds good?
- [ ] Have I identified what went wrong or was difficult?

## During Writing Validation

### Phrase Check

- [ ] Searched for "seamlessly" → Reviewed in context
- [ ] Searched for "Moreover" → Reviewed in context
- [ ] Searched for "crucial role" → Reviewed in context
- [ ] Searched for "comprehensive" → Made specific
- [ ] Searched for "innovative" → Used actual technique name
- [ ] Searched for "transform" → Found better verb
- [ ] Searched for "leverage" → Changed to "use"

### Structure Check

- [ ] Paragraph lengths vary (1-5 sentences)
- [ ] Different paragraph openings
- [ ] No formulaic intro → body → conclusion pattern
- [ ] Mixed sentence lengths
- [ ] Ending fits the purpose; a useful summary may remain

### Voice Check

- [ ] Includes at least one opinion
- [ ] Mentions at least one problem/challenge
- [ ] Contains specific technical details
- [ ] Has context for decisions
- [ ] Sounds conversational, not formal

### Specificity Check

- [ ] Vague improvements → Exact metrics
- [ ] General descriptions → Specific technologies
- [ ] Abstract benefits → Concrete outcomes
- [ ] Broad statements → Narrow facts

## Post-Writing Validation

### The Read-Aloud Test

Read the content aloud and check:

- [ ] Does it sound like a real person?
- [ ] Would you say this to a colleague?
- [ ] Any parts sound like Wikipedia?
- [ ] Any parts sound like marketing?

### The Tired Developer Test

Could you imagine:

- [ ] A developer writing this at 5pm?
- [ ] Someone who actually built this writing it?
- [ ] This being said in a stand-up meeting?
- [ ] This appearing in a Slack message?

### Contextual Pattern Review

- [ ] Punctuation reflects author intent
- [ ] Lists, inventories and questionnaires preserve their required structure
- [ ] Domain terms retain their intended meaning
- [ ] Transitions support the document’s structure
- [ ] Claims, uncertainty and outcomes match the supplied facts

### Optional Editorial Features

The former authenticity checklist score is deprecated. Consider relevant features without adding points:

- [ ] Specific metric included
- [ ] Problem or failure mentioned
- [ ] Opinion stated
- [ ] Trade-off explained
- [ ] Context provided
- [ ] Technical detail specified
- [ ] Informal language used
- [ ] Deadline or constraint mentioned
- [ ] Team dynamic referenced
- [ ] Learning or mistake admitted

**Interpretation:** These features can support a particular writing brief. Their presence or count cannot establish authorship, naturalness or publication readiness.

## Quick Fixes for Common Issues

### If it sounds too formal

1. Remove "It is worth noting that"
2. Replace "utilize" with "use"
3. Cut sentence length in half
4. Add a contraction
5. Keep complete sentences unless the author intentionally prefers fragments

### If it sounds too positive

1. Include what went wrong only if supplied and relevant
2. Mention the trade-off
3. Include the constraint
4. State what you'd do differently
5. Admit the hack or shortcut

### If it sounds too vague

1. Add a source-supported number when useful
2. Name the technology
3. Give the timeline
4. State the metric
5. Include the version

### If it sounds too helpful

1. Remove "I hope this helps"
2. Cut the explanation of why
3. Just state the fact
4. Skip the context setting
5. Don't summarize

## Final Sign-Off Questions

Before submitting, answer:

1. **Would I send this to my team?** Y/N
2. **Does this sound like me on a normal day?** Y/N
3. **Did I mention anything that went wrong?** Y/N
4. **Are my numbers specific?** Y/N
5. **Did I resolve applicable author rules and review advisory phrases in context?** Y/N

Revise factual errors or unmet requirements. Other answers may be not applicable; record deliberate editorial choices.

## Remember

Polish does not indicate authorship. When relevant, the supplied material may include:

- Rough edges
- Strong opinions
- Specific details
- Actual problems
- Human voice

Publish only through the project’s existing author review and approval process.
