Skip to content
SamuraiAPI

Technical communication with applied empathy

We write documentation your users actually understand. They trust your product sooner, get started faster, and rarely need to contact support.

One sentence, rewritten

Add your API key to the Authorization header of every request. You’ll find the key in your dashboard.

Authorization: Bearer YOUR_API_KEY
18 wordsOne action, plus an example

What we do

From a single API reference to a full developer portal, we cover everything your users read on the way to success.

High-quality documentation

Curious beginners and experienced users both need docs that are clear and well structured. We write them in whatever form your product needs.

  • API references
  • User guides
  • Knowledge bases
  • Onboarding tutorials
  • Online help
  • How-to guides
  • FAQs
  • Release notes

Developer portals and landing pages

A developer portal is often where engineers first meet your product. We design and build portals and landing pages that speak to your audience and support your business goals.

Usability testing and UI/UX feedback

We work through your product end to end, report bugs, confusing UI and rough edges in the experience, and then update the documentation so users succeed where they used to get stuck.

What good documentation does for your business

  • More sales

    Clear docs help buyers evaluate your product and say yes sooner.

  • Better user experience

    Users find answers on their own and enjoy working with your product.

  • Lower costs

    Less time spent on onboarding and fewer support requests.

  • Human language

    Complex topics explained the way a person would, not a robot.

How we work

Five steps, from the first call to release day.

  1. Plan

    Define the purpose, audience, delivery channels and deadline.

  2. Research and test

    Interview subject matter experts, review existing docs, and use the software ourselves.

  3. Write

    Docs-as-code or traditional authoring tools, whichever suits your team.

  4. Review and edit

    Review with your experts and test the docs with real users.

  5. Launch

    Release the documentation together with the software.

Our principles

Written with empathy

We write for the person on the other side of the screen. Docs that understand what they're trying to do and where they get stuck build a real connection with your product.

Built on fundamentals

Understand the subject, write clear and action-oriented content, and deliver it on time. Everything else rests on these three skills.

Driven by technology

Software is increasingly sold as APIs and SaaS. We use modern tools to create, publish and maintain documentation that keeps up.

Case studies

A developer documentation portal for a fast-growing European fintech startup

Imburse Payments developer documentation portal

The challenge

A cloud middleware company connecting large enterprises to the global payments ecosystem needed a developer portal: API docs, product overview, quick start, case studies, onboarding and core concepts.

Their existing material was scattered across PDFs, intranet pages and other formats that were hard to read and follow.

What we did

We built an information model for the new content, then rewrote and consolidated everything into one complete set.

The result is much shorter, clearer and easier to navigate, and it follows the customer journey from first look to production.

Who we are

At SamuraiAPI, we believe simpler is better. Every document we write is made with empathy for you and your customers.

Our workspace
  • 15+ years in ITCombined with an academic background, so we focus on the content as much as on the process behind it.
  • Flexible about toolsWe adapt to how your team works and choose the tools that get the best result.
  • DITA and docs-as-codeWe work with DITA-based tools as well as Markdown and Git, and apply design thinking and onboarding-first methods.
  • We test what we documentWe run end-to-end test scenarios and handle documentation operations, including CI/CD, so your docs stay accurate as the product changes.

Let’s talk about your documentation

Tell us about your product and what your users struggle with. We’ll suggest where to start.

Email us

We use your details only to reply to you. See our privacy policy.