blog

How to write DevRel emails that don’t sound like marketing

Sales avoidance as praxis

The term ‘feature creep’ goes back at least as far as a Usenet recap of MacWorld Expo 1990. After a Richard Bretscheider bemoaned being blinded by “the blazing searchlights of industry,” a Paul Campbell replied, saying “Yes!! too many suits!!...fewer really wonderfully new and striking products…Everyone ends up playing ‘feature creep’ with competitors.” As true for the times of harddisks as it is for today’s tacked-on LLMs.

It’s hard to play the long game when there are so many easy wins and short-term gains available. So teams take a quick detour from the roadmap to ship a low-lift generative AI something-or-other. Then build a better version of an update a competitor just released. Eventually, it becomes what the Jargon File defined in 1999 as “a systematic tendency to load more chrome and features onto systems at the expense of whatever elegance they may have possessed when originally designed.” No less of an issue now, but increasingly overshadowed in dev communities by a different kind of creep. Marketing creep.

On a long enough timeline, everyone works for Marketing

In responses to Xe Iaso's What DevRel means to me, Hacker News commenters called it “nearly identical to marketing” and “tricking people into buying shit.” Org charts seemingly aren’t to blame, though, with a 2023 survey finding only 33% of DevRel teams reported to Marketing or Sales while 55% fell under Engineering or Product teams or the CTO.

DevRel managers are quick to double down on keeping Marketing at arms length. One former lead at DigitalOcean wrote “I'd be damned if I let anyone onto my team who was a seller…not even a whiff of it.” That’s an easy stance to take on Day 1. But it gets harder as time goes on.

Eventually, someone with revenue goals is bound to ask for evidence that DevRel is helping the bottom line. So advocates slip in a soft sell here or turn up the evangelism a smidge there, just to have something concrete to point to. Marketing joins the chat.

Other DevRel teams get off a bit easier. They never have to fend off pleas to adopt “engagement KPIs” or “conversion rate optimization.” Instead, their marketing creep might simply be attributed to being surrounded at all times by people with a vision for the best possible product. Through no fault of their own, advocates can’t help but eventually sip the Kool Aid. The longer their tenure, the higher the chance that they ignore the broader, more varied landscape of solutions that devs are interested in.

Or, in the darkest timeline, DevRel has free reign only until it’s a fat enough cow to swallowed whole by Marketing (a la Twilio updating its infamous billboard from “Ask your developer” to “Reduce acquisition costs by 65%”). More of an ambush than a creep but the same idea.

To build a DevRel program that developers love, one that they would never describe as “tricking people into buying shit,” there need to be lines in the sand. Lines that advocates never cross. Even if that means creating an openly adversarial relationship between DevRel and Marketing.

Hacking back the creep

If DevRel is a bridge between engineering/product and external devs, there needs to be more information traveling inbound than content moving outbound. Hacker News user haswell wrote “My [DevRel] job mostly consisted of acknowledging the parts of the product that sucked, and not pulling any punches when discussing options and solutions to problems…I was often the one telling marketing to stop the bullshit, because it made everyone else's jobs (including our customer's) much harder.” It’s hard to imagine developers not fawning over that take on DevRel.

Showcasing community posts in developer newsletters is one way to dilute the Kool Aid. Stripe, for instance, always includes a Community subheading with at least three bullets in their monthly Developer Digests. Coda’s The Docket emails have “our version of the staff-picks shelf at your local bookstore.” Docs their team have read, loved, and then shared. Sharing community content forces internal teams to search for interesting ideas and break out of the Not Invented Here bubble.

Another way to push back on marketing creep is to make a habit out of writing about what your feature/update/API/etc cannot do. When GitHub was pushing Copilot in its April and May 2024 Insider newsletters, the latter included a bullet list of the limitations and the former was an entire issue devoted to when not to use Copilot. Similarly, Stripe’s Shipped lists almost always dedicate a section to outlining what still needs to be done on a project. These send clear signals to developers that DevRel puts clarity above conversions.

You might even want to create multiple newsletters, with some lists for editorializing and others for straightforward product announcements. Plaid lets developers opt into changelog updates and beta invites and opt out of marketing emails that include customer stories and thought leadership articles. Or you can go whole hog like DevRel darling Stytch, which as of this writing seemingly only sends feature releases and bug fix updates. Unambiguous promises to keep the Suits out of the conversation go a long way with the Hacker News crowd.

When forces outside of DevRel’s control blur the lines between developer advocacy and product advocacy, accountability partners can help (a popular arrangement among a whole other brand of evangelists. Here, an impartial person (or tool) holds the team accountable to the sales avoidance ambitions laid out on Day 1.

Accountability might start out as simple as a RegEx pattern for salesy language like “upgrade,” “register,” “only option,” or “best way.” Or a function that highlights banned URLs like sign up pages, Book a Demo forms, or gated eBooks.

Developers hate marketing so much that they might even be willing to hold their noses and use an LLM to classify preachy or promotional language in DevRel content. Anything that’s directionally similar to Gmail’s checkpoints when you don’t attach a file to an email that contains the word “attach.” A backstop that asks “Are you sure you want to say…” before you hit Send on a newsletter that might generate backlash.

One DevRel engineer at Flutter tweeted that “Developer Relations is akin to a red team or aggressor squadron, charged with upskilling an API engineering team by showing them how customer engineers actually think.” By that same logic, a human Hacker News comment might be your number one ally in defeating marketing creep. A cynical developer outside of your DevRel team. Hell, maybe even someone from your community who’s willing to Red Team your newsletters. Encourage them to call out not just “marketing bullshit” but anything that ignores worthwhile alternatives to your product.

Fewer Suits in the room

Devs have been complaining about the “blazing searchlights of industry” since 20Mb external harddisks were the most exciting hardware on the showroom floor. The fact that those lights haven’t faded is only partly due to the direct efforts of marketing.

We’re all predisposed to think that the projects and people we invest our time in are better than all the others. DevRel emails and newsletters, with their coveted keys to developer inboxes, need to be wary of letting that subtle brand of marketing creep in. Annoy developers too much and they can do far worse than boot you out of their inbox. When Adobe updated its ToS to access user content for “automated review,” the front page of Hacker News read “Cancel Adobe” with 649 upvotes (and millions of impressions on X).

Don’t put sellers on DevRel teams. Do give those teams lines in the sand. Don’t publish more to your community than you absorb from it. Do write about the limitations of what you’re working on. Don’t lump developer updates and thought leadership into the same newsletters. And do, for the love of avocados, invite outside devs to hold DevRel accountable for marketing creep.

What customers say about Buttondown

Doesn't matter if you're sending out irregular updates to a few dozen friends, or marketing your business to a thousand recipients. It is absolutely a joy to use. The documentation is great. And Justin provides the best support I have ever encountered. Amazon isn't the world's most customer-centric company, Buttondown is.
Tilde Lowengrimm
Head of Strategy, Red Queen Dynamics
I made the transition from MailerLite and I have no regrets. I also like that Buttondown focuses on the essentials by design and keeps me grounded and centered on what really matters.
Arthur Cendrier
Author, Thoughtful Inquiry
Overall, Buttondown has been terrific to work with and I recommend them for anybody who's thinking of starting a newsletter or moving over like I did.
Andy Magnusson
Customer Engineering Leader
Wanna know how good Buttondown as a product experience is? I upgraded to Basic before sending the first email, and then upgraded again two days later.
Zak El Fassi
Founder, Zaigood Labs
Mailchimp lost me due to their inferior product and the nightmarish merry-go-around experience with their overseas support team. Buttondown won me over with their superior product and second to none customer service.
Sav Tripodi
CEO, Sanico Software
Your support is amazing and I deeply appreciate how available and helpful you are. I LOVE being able to turn tracking pixels off. I didn't even realize this was an option when I signed up and am SO HAPPY to not track people.
Andrea Mignolo
Method & Matter
I'm also impressed with how responsive you are, and how you directly answer customers. Makes it really clear that signing up for your service was a good decision.
Nicole Tietz-Sokolskaya
Software engineer and writer
Very happy with Buttondown, works smoothly, it's very configurable and I love the minimalist design of the UI. It makes me focus on my writing. Plus, I'm super happy to support independent software and I should mention - the support I receive whenever I have a question is warm and quick :)
Martina Pugliese
Data scientist and storyteller
I just tested the RSS to Email feature for one of my blogs and it was incredibly easy to set up. It took me about 30 mins to figure out the same feature in Mailchimp.
Nicolas Bernadowitsch
Blogger
This long weekend I fulfilled a long-standing promise to myself to switch my RSS-to-email provider from Mailchimp to Buttondown, and it’s been such a great experience. It’s cheaper, more flexible, less cluttered, and it’s run by Justin Duke who is just delightful and answered a bunch of my questions over the weekend (even though I asked him to please not!).
Rian van der Merwe
Director of Product at PagerDuty
I've been wrangling half a dozen tools to get my stuff up and running recently, almost all of which had some hiccup. Buttondown had zero. It did everything I expected and needed the first time.
Catherine Cusick
Self-Employed FAQ
I, like almost everyone else I've seen talk about Buttondown, am IMMENSELY happy and impressed with your customer service. It turns out we can have nice things, which is really refreshing.
Ed Yong
Staff writer, The Atlantic
Email makes the world go ‘round, and Buttondown is how I manage it all for my keyboard projects.
Tim van Damme
Founder, MVKB
It's a truth, that should be more universally acknowledged, that Buttondown is the best newsletter software. Simple, does exactly what it sets out to do, and reasonably priced.
Noel Welsh
Founder, Inner Product
Buttondown is the perfect fit for my headless newsletter use case. And I contacted support with some specific requests and Justin responded within 30 minutes with great answers and a nice pinch of charm.
Sam Roberts
Software engineer, Tamr
Hands down the easiest way to run a newsletter - and the free version is generous!
Javeed Khatree
SEO expert
With API and Markdown support, you can build workflows that make it so easy to write.
Westley Winks
Peace Corps
I’ve never enjoyed writing newsletters as much as I do with Buttondown.
Kevin Lewis
You Got This!
Buttondown remains the easiest thing I use regularly, and I am grateful for that.
Casey
Journalist
It's a humble app doing a common job but with end users in mind.
Si Jobling
Engineering Manager
Buttondown has been an amazing experience for me. The service is constantly being improved and customer service is the best. My newsletter with Buttondown has grown from a fairly small list to over 15,000 subscribers, and it hasn't broken a sweat yet.
Cassidy Williams
CTO, Contenda
I switched over to Buttondown from Mailchimp because of the difficulty I had with Mailchimp's campaigns, so Buttondown's easy and user-friendly system has been a genuine breath of fresh air.
Jessi Eoin
Illustrator + Comic Artist
You’ve truly built a great product that I feel good about using (vs a monopoly from our tech overlords).
Rachel
2030 Camp
I love how personal Buttondown feels, especially compared to Mailchimp, Convertkit, and services like that.
Simen Strøm Braaten
Designer
This product has been exactly what I’ve needed!
Nathan Bird
Podcast host, Chattanooga Civics
It's already so refreshing compared to the mega companies.
Casey Watts
Author, Debugging Your Brain
Definitely will be using for the foreseeable future. It’s a great service and I feel well cared for. Thank you!
Phoebe Sinclair
Author
I’m a sucker for elegant UI and I really love your site, but above that I think your product has so much value for so many different people. I’m not a coder, I’m only familiar with the bare basics, but I was able to figure out and utilise Buttondown quickly.
Claudia Nathan
Founder, The Repository
The killer feature for me: Buttondown will take an RSS feed then automatically slurp up the content (in their words) and then send it to our subscribers. Job done. They seem like a good company too, so I’d say this is a winner.
Andy Bell
Founder, Set Studio
As a recent user of Buttondown, they are super on the ball. A week ago I discovered a security vulnerability and reported it on Friday afternoon. They acknowledged and fixed it in under two hours. On a Friday night! Talk about going above and beyond for your users!
Predrag Gruevski
Principal Engineer, Kensho
Well may I just say your support experience is already approximately 1 billion times better than ConvertKit. Excited to be switching!
Michael J. Metts
Author, Writing is Designing
Privacy focused sending and sign up form; lets me focus on writing - editor is "just" markdown; simple, elegant design template looks like a blog post; the founder is amazing - he's helped with every question I've had, even outside of Buttondown.
Joe Masilotti
Founder, RailsDevs
We need more nice and professional services like yours on the web.
Tobias Horvath
Designer and developer
No one is paying me to say this, but I love @buttondown so far for my lil newsletter. It’s so smart, simple, and attractive (and to my knowledge, not actively anti-trans!). Customer service is also legitimately excellent.
Julie Kliegman
Copy chief, Sports Illustrated
I love it! It lets me breathe, not compete as I write with other writers.
Devin Kate Pope
Writer and editor
It’s a pleasure working with you. Thank you! (And what a contrast with Mailchimp, where I spent two weeks and a dozen of emails trying find out why our form goes down sometimes (only sometimes), and never really got a real answer.)
Anton Sotkov
Software Engineer, IA
Buttondown exemplifies how I wish most software worked, and I hope to achieve a similar thing with the software I develop in the future.
Matt Favero
Software engineer
It feels incomparably good to be able to email just like a guy named Justin when you have a @buttondown question 15 minutes before you’re about to blast a Geistlist email. (Not a guarantee but wow this guy is human-level good.)
Jacob Ford
Designer About Town
Enter Buttondown, Justin Duke’s lovely little newsletter tool. It’s small, elegant, and integrates well. And it is also eminently affordable.
Will Buckingham
Author
Your settings page is a joy to use and everything about Buttondown makes me happy.
Gareth Jelley
Magazine editor
have been on Buttondown for ~18 months and I can't recommend it enough.
Elizabeth Minkel
Podcast host
You really do make ALL other customer service look terrible by comparison.
Chris Mead
Improv teacher
There is a caring person on the other side of this software, which is one of the things I like the most about Buttondown.
Keith Calder
Film & TV Producer
I’d also like to add that @buttondown is an absolute joy to use. Hats off, Justin!
Elliot Jay Stocks
Creative Director, Google Fonts
Shoutout to @buttondown and @jmduke for building an amazing bootstrapped product for newsletters, all while being very open to feedback and connecting directly with customers 🙏 Easily one of the most enjoyable product experiences I've had.
Den Delimarsky
Head of Ecosystem, Netlify
if you are looking for "newsletter tool for hackers" i tentatively believe the answer is @buttondown full api, compose in markdown, good docs for setting up domain auth, simple subscribe form HTML that you style yourself (or not)
Brian David Hall
Author, Your Website Sucks
I really like @buttondown as a blogging platform, it has the simplicity of Substack but the corporate culture is less toxic.
Chad Loder
Extremism researcher
I worked with @buttondown and asked for some new payment support beyond the supporter single tier / pay-what-you-want options. Justin was great and built it in just a couple days.
Dan Hon
Author & consultant
I write nonfiction and I use @buttondown buttondown.email/Changeset - indie, GREAT personal customer support, very nice default styling, all the options I want including ones to protect my readers' privacy
Sumana Harihareswara
Open source maintainer
I use @buttondown because it does exactly what I need (manage subscribers and send markdown emails), not more and not less 👍 As a bonus it's made by an indie dev which I love!
Max Stober
Founder, GraphCDN
If you’re considering running an email newsletter, or if you already run one and are considering a change of provider, I highly recommend @buttondownemail. Super-easy app, very fair pricing with a generous free tier, and exemplary support. 💯
Peter Gasston
Technologist and speaker
imo @buttondown is easily one of the best-designed services i’ve used in recent years, if you have a substack you should really consider switching!
Kabir Goel
Engineer, Cal
Thanks for getting me excited about email newsletters again.
Garrick van Buren
I'm very thrilled that I can just write in Markdown without having to deal with email builders and all that crap.
Parham Doustdar
Thanks again for all the help! You’ve really turned something super complex into something super easy – sending new issues is as simple as firing off a text message.
Kartik Chaturvedi
Thanks for creating a simple way for people who want to, like, put words in a hole and have it sent to people... I am just thankful that something just nice and human exists on the internet.
Emmanuel Quartey
I tried 3 other newsletter services today and I felt like wanting to rip my hair out. They were all painfully slow. I'm so glad I found Buttondown.
Mohamed Elbadwihi
I’ve found Buttondown to be a great fit for my workflow and have been delighted by all of Justin’s thoughtful features and improvements to the product.
Michael Lee
Like seriously, so many lovely little easter eggs in one could-be-boring service.
Alexandra Muck
I just switched over from Tinyletter and I'm really excited to have found a place to host my tiny newsletter that doesn't seem like it's assuming everyone sending newsletters is an email marketer / growth hacker.
Tessa Alexanian
I'm in love with the simplicity of Buttondown.
Ekfan
I’ve used similar tools in the past and Buttondown is by far the simplest to use and most promising.
Fabrizio Rinaldi
Thank you for creating such a simple and brilliant tool. I’ve just signed up and the experience has been smooth and painless (the docs are great too!)
Oliver Holms
As a developer who has hated every email system I've ever used this is so nice.
Drew Hornbein
I wish I still wrote a newsletter just so I could use buttondown again. It’s like that.
Steven Kornweiss
No credit card required. Only pay for what you use. Cancel anytime.