The "Resources" tab is the most loved and hated tab for developer marketers.
Ok so the common problem is that you have lots of different resources:
You want to showcase them in the navbar but where do you put them?
Under product? Company? Docs?
How to make sure that people don't go to your blog to read about your product just to find out that you talk about the industry problems there?
Enter the "Resources" tab. The "Miscellaneous" of the navbar world.
And typically it is just crammed with all stuff that doesn't fit anywhere. Just like any respectable misc folder would. ย
How do you deal with that?
Snyk approached it in a clear and logical way:
I love this (and already stole the idea for our site).
How to write a "What is {MY CORE KEYWORD}" article that gets to the top of HackerNews? ๐
First of all, almost no one succeeds at that as you write those articles for SEO distribution, not HN distribution.
To get an SEO-first article on HN your content quality bar needs to be super high.
But you can do it.
PlanetScale managed to get their "What is database sharding and how does it work?" on the orange page (kudos to Justin Gage!).
Here is what was interesting about that article:
๐ฆ๐๐ฝ๐ฒ๐ฟ ๐๐ผ ๐๐ต๐ฒ ๐ฝ๐ผ๐ถ๐ป๐ ๐ถ๐ป๐๐ฟ๐ผ.
โข โ No "In today's fast-paced data-driven world enterprises work with data" stuff.
โข โ
Justย ย "Learn what database sharding is, how sharding works, and some common sharding frameworks and tools."
๐๐ถ๐๐๐ถ๐ป๐ด ๐ธ๐ฒ๐๐๐ผ๐ฟ๐ฑ๐ ๐๐ต๐ถ๐น๐ฒ ๐ฏ๐๐ถ๐น๐ฑ๐ถ๐ป๐ด ๐ฟ๐ฎ๐ฝ๐ฝ๐ผ๐ฟ๐ ๐๐ถ๐๐ต ๐๐ต๐ฒ ๐ฑ๐ฒ๐ ๐ฟ๐ฒ๐ฎ๐ฑ๐ฒ๐ฟ.
๐ Speaking peer to peer, not authority-student:
โข "Youโve probably seen this table before, about how scaling out helps you take this users table, all stored on a single server:"
โข "And turn it into this users table, stored across 2 (or 1,000) servers:"
โข "But thatโs only one type of sharding (row level, or horizontal). "
๐จ๐๐ถ๐ป๐ด ๐ท๐ฎ๐ฟ๐ด๐ผ๐ป ๐ฎ๐ป๐ฑ ๐๐ป๐ฑ๐ฒ๐ฟ๐๐๐ฎ๐ป๐ฑ๐ถ๐ป๐ด ๐๐ผ๐๐ฟ ๐ฎ๐๐ฑ๐ถ๐ฒ๐ป๐ฐ๐ฒ
Things like:
โข "Partitioning has existed โ especially in OLAP setups"
โข "Sifting through HDFS partitions to find the missing snapshot "
๐๐ฐ๐๐๐ฎ๐น๐น๐ ๐ฒ๐ ๐ฝ๐น๐ฎ๐ถ๐ป๐ถ๐ป๐ด ๐๐ฒ๐ฐ๐ต๐ป๐ถ๐ฐ๐ฎ๐น๐น๐ ๐ต๐ผ๐ ๐๐ต๐ถ๐ป๐ด๐ ๐๐ผ๐ฟ๐ธ
๐ฅ Look at the section "How database sharding works under the hood" with subsections:
โข Sharding schemes and algorithms
โข Deciding on what servers to use
โข Routing your sharded queries to the right databases
โข Planning and executing your migration to a sharded solution
๐ ๐๐ผ๐ป๐๐: ๐ฝ๐น๐๐ด ๐ถ๐ป ๐๐ผ๐๐ฟ ๐ฝ๐ฟ๐ผ๐ฑ๐๐ฐ๐ ๐ด๐ฒ๐ป๐๐น๐
Section "Sharding frameworks and tools" shares open-source tools (every dev, but HN devs in particular like OS projects).
And there as an info box, you have the info that Planetscale comes with one of those OS projects deployed.
Just a beautifully executed piece of content marketing.
One of the top-performing conversion flows in dev-focused articles.
"Aside CTA" in the "How to do {jobs to be done}" article.
You know the drill:
And Export SDK executes it (almost) perfectly:
One thing that could be tested and changed is putting this "Aside CTA" mid-article and not at the end (tip from Martin Gontovnikas).
A good thing to try if you are running the "How to do {jbtd}" article strategy.
I like that this is both strong and subtle.
It comes right after I've delivered a smell of value with a technical intro.
And I can see that there is more value to come after thanks to the table of contents.
The CTA itself feels like an info box in the docs rather than a typical subscribe CTA.
Good stuff.
There are a few developer experience gems here:
Also, their design is super clean, non-invasive, and simple which makes for easy content consumption and more developer love.
This is one of the more devy blog designs I've seen in a while.
It has this docs-like feel.
But is just a bit more fun and loose than most docs would allow.
Here is what I like:
And if your posts are code-heavy, then a docs-like experience is where you want to be anyway.
But you can spice it up with things that wouldn't fit the docs.
Like a Twitter/X embed or a meme.
Subtle but effective dev blog CTA -> info box.
Basically a plain article in-text CTA but there is something special about it.
It looks like a docs info box.
It is not a "buy now" style call to action but rather a subtle "you may want to know about X" push.
But for it to really feel like an info box it needs to connect to the section of the section of the article around it.
Otherwise, it will just feel like an intrusive ad anyway.
PlanetScale does a great job here.
They link the part of the article about the sharding library Vitess with their product that was built on top of it.
It feels natural and I am sure it gets clicks and if not then product awareness.
Interesting dev blog CTA idea from V7.
CTAs in technical articles is a tricky subject:
I like how V7 approached it here:
What I'd change/test is making this CTA not a generic value prop but something closely connected to the rest of the article.
One of the best types of developer content is a debugging story.
"What is X" or "How to solve Y" work in some situations, especially when you focus on SEO distribution. But a good debugging story is something that even senior devs want to read.
This is an old article from the GitLab and is such a good example of thos format:
The downside of using this format is the same as with most good developer content. You need a real situation, explained by an actual dev in a technical language.
The idea behind this conversion play is to put an "Aside CTA" that is unrelated to the content early in the article.
And get that clicked.
But obviously, if you do that it will be pushy and intrusive.
So?
Nevo David from Novu shared this idea on one of the podcasts:
Btw, Nevo says that cat memes work best.
This is how you write dev tool JTBD blog posts.
Masterclass of writing this type of content from @WorkOS imho.
Deep 2000 word guide that explains how to add webhooks the your application.
Goes into examples, best practices, everything.
One thing it doesn't do?
It doesn't push the product left right and center.
In fact, the only CTA is hidden in the very last sentence of the very last section.
Why?
Because most likely, the reader's intent is around understanding the problem at this point.
They want to understand what adding webhooks to their app really means from the practitioner's standpoint.
And they did that beautifully.
Could you have pushed the product a bit more? Sure.
But by answering the actual questions devs came here for they managed to build trust.
And I am sure got their fair share of click-throughs and signups anyway.
I like those sidebar CTAs from Auth0.
They go with a sticky Table of Contents which gives a better reading experience.
They put two CTAs below that TOC:
Solid job.
Need one more call to action idea for your dev tool blog?
How about starting an article with it?
Sounds weird but if done right it can work. Even with devs (or maybe especially with devs).
Earthly did and they are known for great dev-focused content.
Ok, so how does it work?
You start your article with a contextual call to action where you explain:
And then you let people read.
Those who find the topic important will remember you and/or maybe click out to see more.
I like it. It's explicit, transparent, and actually noninvasive.
An interesting option to push people to read the next article.
You use a slide-in triggered on a 75% scroll with a "read next" CTA in the bottom left.
On the aggressive side for sure but when the article you propose is clearly technical it could work.
And if your articles are not connected to the product explicitly you do need some ways to keep people reading and see more of your brand.
Adding CTA in dev-focused articles is hard.
You don't want to be too pushy, but you do want to get conversions.
DigitalOcean strikes a great balance with its in-text article CTA design.
They make this CTA look like an info box that you'd typically see in the documentation.
It is clear that it is a Digital Ocean CTA but it doesn't feel pushy.
It feels like a piece of potentially useful information.
Love it.
Funny dev newsletter CTA. From shiftmag .dev by Infobip.
It starts with a chuckle-worthy:
"Sarcastic headline, but funny enough for engineers to sign up"
Then they follow up by disarming the "is that spam" and building more rapport with:
They end with an alternative call to action. RSS feed.
Most newsletters don't do RSS.
But for many devs RSS feed is the preferred content subscription.
Great job!
Pushing cold blog readers to try your tool rarely works.
So you need a transitional CTA, something that worms them up.
But it needs to be aligned with the goals of the reader.
And I think pushing folks to a community discord is a solid option.
I like the copy "Discuss this blog on Discord" as it is very reader-focused.
Some folks read the article and have more questions.
They want to discuss it somewhere.
And while you could just do a comments section, a community gives you more options to get people closer to the product.
This is one of my favorite our dev tool vs competitor blog posts.
With these pages, you want to explain when you are better.
But you don't want to berate your competitor.
And above all, you want to help people make a decision.
Chances are (almost 100% ;)) that you are not better for every use case. And your developer audience knows it.
But there should be use cases, tool stacks, or situations when you are the best option.
Talk about those. Dev to dev.
@Convex did a great job in this post that I think can be a template for how to write these:
After reading that post you are fairly convinced that if your situation matches the one described and if it makes sense to use it.
Love it.
A classic dev tool blog call to action that is somewhat underused these days.
Was going through Martin Gontovnikas blog and found a post from a couple of years back.
He called this "Aside CTA" and the idea is this:
Why this can work well with devs is:
Definitely a classic that is worth trying.