I’ve been having a lot of conversations lately with designers and developers about how AI coding assistants are changing what content we actually need. And honestly, it’s forcing me to rethink everything about how we approach DevRel content.
The context: I watch developers use Claude and Cursor every day to build interfaces that my tutorials used to teach. When AI can generate a complete React component from a description, what’s the point of my “How to Build a Button Component” tutorial?
At first, this felt threatening. Then I realized: maybe we’ve been creating the wrong content all along.
The Shift: From “How” to “Why”
My startup failed in 2024. We had comprehensive documentation, video tutorials, example code. But when I did post-mortems with users, the recurring theme wasn’t “we couldn’t figure out HOW to use your product.” It was “we couldn’t figure out WHEN we should use your product vs alternatives.”
Documentation wasn’t our problem. Decision-making guidance was.
Now I’m leading design systems at a larger company, and I’m applying this lesson. Our most valuable content isn’t “how to implement a button component” - AI handles that brilliantly. Our valuable content is:
- Why we chose this button pattern over five alternatives we considered
- Trade-offs between different approaches and when each makes sense
- Real-world scenarios where this pattern solved specific problems
- Edge cases and gotchas we discovered through painful experience
What AI Can’t Provide (Yet)
I’ve been experimenting with AI tools for both code generation and content consumption. Here’s what AI does brilliantly:
- Generate syntactically correct code
- Explain standard patterns and best practices
- Provide working examples for common use cases
- Troubleshoot error messages
Here’s what AI struggles with:
- Context and judgment: “Should I use React or Vue for THIS specific project?”
- Experience-based wisdom: “Here’s what went wrong when we tried approach X”
- Taste and craft: “Why this interaction pattern feels more delightful”
- Cultural and emotional context: “This design choice builds trust with users”
- Trade-off discussions: “Here are the pros/cons we weighed in this decision”
Content Types That Matter in 2026
Based on what I’m seeing, here’s what DevRel content should focus on:
1. Decision Frameworks
Not “how to implement X” but “when to use X vs Y vs Z.” Help developers make good choices, not just execute implementations.
Example: Instead of “How to implement caching,” write “When to use Redis vs Memcached vs in-memory caching: a decision framework based on your specific constraints.”
2. War Stories and Failure Narratives
AI can tell you the happy path. Only humans can share the painful lessons from production incidents.
Example: “We migrated to microservices and here’s what went wrong: 5 lessons from 6 months of pain”
3. Trade-off Discussions
Real-world decisions involve trade-offs. Document the trade-offs, not just the final choice.
Example: “Why we chose PostgreSQL over MongoDB: the trade-offs we considered for our specific use case”
4. Taste and Craft
AI can’t teach taste. Focus on the subjective, experiential aspects of building great products.
Example: “Designing for delight: how animation timing affects perceived performance”
5. Architectural Patterns
Not just “how to build a microservice” but “when microservices make sense vs when they’re overkill.”
The Documentation Paradox
Here’s something interesting: comprehensive documentation is more important than ever, but for a different reason.
Before AI: Developers read documentation to learn how to use your product.
With AI: AI reads your documentation to help developers use your product.
This changes what good documentation looks like. You’re writing for both audiences:
- Human developers who need context, judgment, and trade-offs
- AI models that need comprehensive, structured, accurate technical details
What I’m Changing in Our Content Strategy
At my company, we’re shifting our content focus:
Reducing:
- Basic “how to” tutorials (AI handles these)
- Syntax reference docs (AI is better at this)
- Simple example code (AI generates this on-demand)
Increasing:
- Decision frameworks and trade-off discussions
- Failure stories and lessons learned
- Architecture pattern guidance
- Taste and craft content
- Real-world case studies
The Question: What Content Will Matter in 3 Years?
Here’s what keeps me up at night: AI is improving fast. Things it can’t do today, it might do tomorrow.
So what DevRel content will still be valuable in 2029?
My bet: Content that provides human context, judgment, and experience. Content that helps developers make good decisions, not just execute implementations. Content that shares the “why” and “when,” not just the “how.”
But I could be wrong. What do you think? As developers, designers, product people - what content actually helps you in your work? What do you wish DevRel teams would create more of?