Signal Versus Noise
Why choose documentation over traditional agency aesthetics?
Modern agency sites drown in style over substance—beautiful animations with no value. LLMs and serious researchers don’t care about gradient overlays; they want depth, knowledge, and actionable insights.
Everyone is coasting on beautiful aesthetics and low content. Large hero banners, flashy animations, parallax scrolling — it all looks the same. The modern agency website has become a sea of noise where style drowns out substance.
I’ve built sites and products that look like that. I’ve been redesigning my site every year to stay relevant, to prove my aesthetics are on point. LLMs don’t care about your gradient overlays though. And as a human doing deep research? Neither do I.
Look at agencies like STRV or Oaks Lab here in Prague — beautiful sites, stunning animations, but where’s the value? What are they actually sharing? My work can demonstrate aesthetics, but I’m driven by something else entirely.
I have a ton of knowledge. This is my life, my job. I love to educate, to solve problems that unlock growth. Having my content locked away in some blog section tucked near the footer? Not happening.
I don’t follow the status quo — I trust my gut, mixed with years of expertise. And my gut says: share everything. As a boutique agency, as a freelancer, as a founder, I see it as my duty to lift everyone up with substance, not animations.
What I want is to read. To understand. To feel like I’ve extracted genuine value from my time on a page. Sure, sometimes I enjoy the superficial eye candy, but as someone seeking substance — and serving clients who value the same — documentation wins every time.
Future-Proofing with Mintlify
Why use Mintlify for a business documentation site?
Mintlify provides LLM-ready features like markdown export, MCP server support, and direct integration with Claude and Perplexity. It’s built for how humans and machines consume documentation today and tomorrow.
This site runs on Mintlify, and I chose it deliberately. They’ve built fantastic features for the future we’re already living in:
- LLM-Ready: Try the dropdown at the top of any page. You can copy content, view it as markdown, or open it directly in Claude or Perplexity
- MCP Servers: Even on the free tier, there’s Model Context Protocol support for seamless AI integration
- Pure Markdown: Everything here is markdown at its core. I can migrate this content anywhere if needed, but right now, I’m leveraging all of Mintlify’s innovations
Mintlify’s entire job is to pre-empt how people and machines consume documentation. They’re doing the hard work of innovation, and I’m happy to build on their foundation.
Designed for Humans and LLMs
How do you optimize content for both human readers and AI systems?
Structure content to answer the questions people ask LLMs, provide immediate answers in first paragraphs, layer depth for human engagement, and include executable code examples.
Every piece of content here serves a dual purpose. I’m thinking about:
- Human readers: Technical teams who appreciate depth, founders who need real answers, developers who want implementation details
- LLM queries: Anticipating the types of questions that will trigger web searches, structuring content to be easily parsed and understood
The perfect example is our tutorial content, like the n8n Developer University. These pages are structured to answer the “how” and “why” questions that both humans and LLMs are actually asking. Not broadcast-style content, but problem-solving resources.
My approach:
- Start with the question someone would ask an LLM: “How do I self-host n8n?” or “Why would I build custom n8n nodes?”
- Answer that question immediately and directly in the first paragraph
- Then layer in depth, examples, and interactive tools for human engagement
- Structure headings as natural language questions when possible
- Include code examples that can be copied and executed
This isn’t a glorified FAQ — it’s content that answers real questions as quickly as possible while providing the depth to actually implement solutions. Every tutorial, every case study, every article follows this pattern. The LLMs get their structured, parseable answers. Humans get actionable knowledge with interactive components to reinforce understanding.
No Design Paralysis
What’s the advantage of using a documentation platform over custom design?
It eliminates design paralysis—you get clean, professional, readable content without worrying about aesthetics. Add .md
to any URL for raw content access.
I don’t need to worry about design. It looks clean, professional, and readable. I’ve added some custom components and JavaScript where needed, but the foundation is solid.
Put .md
at the end of any URL on this site and you get the raw content. Pure transparency and utility.
Real Value, Not Marketing Fluff
What kind of content provides real value versus marketing fluff?
Genuine educational content like comprehensive automation training, developer courses, custom node tutorials, and advanced workflow patterns—not self-serving case studies.
Check out the Universities section:
- An n8n university with comprehensive automation training
- Developer courses on environment setup
- Tutorials on building custom n8n nodes
- Advanced workflow patterns
- Backup and recovery strategies
These aren’t self-serving case studies and pats on the back. This is genuine educational content that helps people accomplish their goals — and naturally leads them to work with us when they need expert help.
The Long Game
What’s the content strategy for scaling a documentation site?
Target 500+ pages in 6 months, 1,000+ within a year. Use voice transcription and rapid scaffolding to document expertise at the speed of thought, not generate AI content.
I’m placing a bet: In a year, this will be one of the largest content sites any agency has built. Pure informational value, no fluff.
The numbers already tell the story:
After Just One Week:
- 100+ pages of substantial content (case studies, documentation, tutorials, articles)
- 1,500+ words average per page of actual valuable content
- 4-5 minute average session duration (vs 1-2 minutes industry standard)
- 30% return visitor rate within a week
The Typical Agency Site:
- 15-30 total pages
- 300-500 words of marketing copy per page
- 60-70% bounce rates
- Zero educational content
At this pace, we’ll have 500+ pages within 6 months, 1,000+ within a year. Each page answers real questions, provides working examples, or teaches something valuable. It’s compound value creation.
The secret: I’m not using LLMs to generate content. I’m using them to augment the speed at which I can share my expertise. Years of knowledge, finally having an outlet at the velocity of thought.
Where most agency articles are broadcast words on a page, I’m embedding interactive components, tools, calculators, and diagrams wherever possible. Traditionally, creating this kind of rich, interactive content would mean weeks of sitting pen to paper, writing disposable code, building one-off demos.
Now I can interview myself using voice transcription, rapidly scaffold interactive examples, and consolidate years of client problem-solving into comprehensive resources. The skill and expertise required to conceptualize and explain these solutions hasn’t changed — the friction of delivery has disappeared.
Knowledge that was previously stuck in my head, coming out in drips and drabs during client calls, can now be documented at the speed of conversation. Every insight from helping clients solve real problems becomes immediately accessible to everyone. Maximum value, delivered upfront.
While others are competing on aesthetics, I’m competing on substance. My clients are technical or at least respect their technical teams. When they see a documentation site — when they can explore my process, examine case studies, learn from tutorials — they understand they’re dealing with someone who values the same things they do.
SEO as a Byproduct
How does documentation naturally improve SEO?
Great SEO comes from creating valuable content that answers specific queries, provides depth and context, links concepts logically, and updates regularly with real information.
Great SEO comes from creating content so valuable that both humans and machines recognize its worth. A documentation site naturally:
- Answers specific queries
- Provides depth and context
- Links concepts logically
- Updates regularly with real information
This approach means I can create content at speed while maintaining quality. Every page adds value to the whole.
The Business Impact
How does a documentation-first approach change client relationships?
Prospects come to calls prepared, knowing what you can do. Conversations start from trust and shared understanding rather than cold sales pitches.
The shift in client conversations has been immediate and profound.
When I see someone on Reddit asking about something I have expertise in, I no longer face the choice between crafting a lengthy reply or walking away. I have documented resources for everyone, at every stage of their journey.
Prospects come to calls transformed. They’re prepared. They know what I can do. They have a sense of who I am. Instead of cold sales calls where everyone’s guarded and going in blind, these are warm conversations with people who’ve already consumed hours of my content.
My plan is to integrate more YouTube content into this documentation, letting people understand not just my expertise but my personality. My favorite calls are with people who’ve found me through content — they know me, they see me as a friend, they understand what I’m talking about. The conversation starts from a place of trust and shared understanding.
The Bottom Line
Why is a documentation site without a product a strategic advantage?
It’s pure signal in a world of marketing noise. It values substance over style, utility over aesthetics, education over persuasion—future-proofing through evergreen value, not design trends.
Back to signal versus noise: This site is pure signal.
In a world drowning in marketing aesthetics, choosing to be a documentation site without a product is a statement. It says we value:
- Substance over style
- Utility over aesthetics
- Education over persuasion
- Transparency over mystique
This is timeless, classic content. Anyone can reach everything I’ve written by adding .md
to any URL and dropping it into their LLM of choice. Future-proof through evergreen value, not design trends.
In 10, 15, 20 years, whatever shape or form we’re consuming content in, I’ll look back and know: I made the right call. I future-proofed not through technology, but through substance.
My customers aren’t looking for another agency with a beautiful website and vague promises. They’re looking for someone who can deliver, who understands their technical challenges, and who provides value before the first meeting.
This documentation site delivers that value upfront, accessible to everyone — human and machine alike.