Dev tool Hacker News marketing examples

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.

𝗛𝗼𝘄 𝘁𝗼 𝗰𝗿𝗲𝗮𝘁𝗲 𝗴𝗼𝗼𝗱 𝘁𝗲𝗰𝗵𝗻𝗶𝗰𝗮𝗹 𝗰𝗼𝗻𝘁𝗲𝗻𝘁 𝘁𝗵𝗮𝘁 𝘁𝗵𝗲 𝗛𝗮𝗰𝗸𝗲𝗿 𝗡𝗲𝘄𝘀 𝗮𝘂𝗱𝗶𝗲𝗻𝗰𝗲 𝗹𝗶𝗸𝗲𝘀?

The general tip is simple. Create content that the HN audience finds interesting.

𝗧𝗵𝗮𝘁 𝘁𝘆𝗽𝗶𝗰𝗮𝗹𝗹𝘆 𝗺𝗲𝗮𝗻𝘀:

• Something that feeds curiosity (how does X work, why did Y happen, what is it like to do Z)
• Something real, transparent, and written in first person (real stories)
• Something technical and focused on the dev or founder crowd

But how do you actually do that?

𝗢𝗻𝗲 𝗼𝗳 𝘁𝗵𝗲 𝗽𝗹𝗮𝘆𝗯𝗼𝗼𝗸𝘀 𝘁𝗵𝗮𝘁 𝘀𝗼𝗺𝗲 𝘁𝗲𝗰𝗵𝗻𝗶𝗰𝗮𝗹 𝗳𝗼𝘂𝗻𝗱𝗲𝗿𝘀 𝗱𝗲𝗽𝗹𝗼𝘆𝗲𝗱 𝘄𝗮𝘀 𝘁𝗵𝗶𝘀:

• Get your technical founder or core developers to write articles
• Those articles are focused on the technical challenges of building your product
• Again, don't write what your product does but rather how you build it. Mistakes you made, ideas you tried, technical challenges you had to overcome.
• Share real value with that dev audience. And to give people real value, you need to have folks who actually understand their problems. Those are typically senior devs/founders.
• You will inevitably hint that you are building a product and the folks who are interested in your product and you will go deeper.  

That was exactly what folks from CockroachDB did at the beginning.  Heard about it on one of the episodes of the Unusual Ventures podcast with Peter Mattis from Cockroach Labs.

𝗘𝘅𝗮𝗺𝗽𝗹𝗲𝘀 𝘁𝗵𝗮𝘁 𝗵𝗶𝘁 𝘁𝗵𝗲 𝘁𝗼𝗽 𝗼𝗳 𝗛𝗡:

• "CockroachDB Stability Post-Mortem: From 1 Node to 100 Nodes"
• "Serializable, lockless, distributed: Isolation in CockroachDB"
• "How CockroachDB Does Distributed, Atomic Transactions"
 
Kudos Cockroach Labs team and thanks for sharing!

Newsjacking is a great marketing tactic.
Especially when you can connect it nicely to your product.
‍

And GitGuardian, a tool for secrets management does it beautifully here.
They ran a story on how Toyota suffered from a data breach.
Because they didn't manage their GitHub secrets properly.
‍

Brilliant.

Hacker News developer audience doesn't love promotion to put it mildly.

But some dev tool companies manage to make this audience their biggest ally.

Fly.io is one of those companies.

And they had a super successful product launch a few years back.  

So how did they do it?

• "Who"
• "Problem"
• "What" and "How"
• *Speak "dev to dev". Spec no fluff.

Let's go through these in detail.

Who are you? Why should I listen?

• show your face
• Say who are you and
• hint at why should I trust you

What is the problem really?

• Describe how you discovered the problem
• Agitate that pain, explain technicalities deeply
• Share your stories dealing with that problem (ideally obvious solutions that didn't work)

What does your product do and how does it work?

• Say what it is, like a technical spec.
• Say what it does, like really, low-level job to be done
• Explain how you solve it, be deeply technical

Speak "dev to dev"

• use technical jargon and relevant terms: "docker image", "global router", "VMs", "root filesystem"
• don't explain like I am 5, explain like I am 5 years in my dev journey "we convert docker images into a root filesystem, boot tiny VMs..."
• Don't use words that don't really mean anything and just take space. Speak MECE (mutually exclusive, collectively exhaustive)

By doing it this way you have a chance of gaining love from the prolific HN crowd.

Fly.io definitely did, and is still reaping rewards with constant HN exposure.