Welcome to your monthly round-up in the world of documentation from the Tech Writing team at FINN!

The best things we read last month 🤩

Expectation management for API products - setting yourself up for (developer) success

Szabina Oláh explores the four types of expectations relevant for APIs and offers tips on how to understand and meet them.

What the “Cobra Effect” Says About API Metrics

Matthew Reinbold offers practical advice on avoiding proxy failures when selecting metrics to measure the business impact of your APIs.

How to create an API style guide, and why

How do you ensure consistency for your consumers in your API design? James Higginbotham of Tyk discusses how an API style guide could be the right solution to this problem.

Rethinking Your Data Platform Documentation So That People Actually Read It

How did Deezer overhaul their data platform documentation in just a couple of months? Arthur De Kimpe shares tips and tricks on creating documentation that meets the users where they are.

Documenting database schemas

Mark Wentowski shares some best practices for creating RDBMS documentation and how you can get started documenting today.

How to design climate-friendly emails

”As an industry, communications tech accounts for almost 4% of global carbon emissions. By 2025, if tech were a country, we’ll be the fourth largest polluter behind China, India, and the U.S.”

Save the date

Upcoming virtual events in November.