Skip to the content ForoHackers
Log inJoin

Developer relations: start here

Developer relations
#2889 · · Quote · Report

Developer relations is the work of helping outside developers succeed with a platform, library or API, and carrying what they say back to the people who build it. It mixes teaching, writing, speaking, sample code and listening. Credibility comes from being a working engineer who respects the audience's time.

Key concepts

  • Developer experience: the whole path from first look to a working result; every friction point is a lost user.
  • Time to first success: how fast a newcomer gets something real running.
  • Content: tutorials, samples, talks and videos, each aimed at a clear audience and goal.
  • Feedback loop: collecting questions and bug reports, finding patterns and getting them fixed.
  • Community: forums, events and maintainers who answer, thank and welcome.

Vocabulary

  • Advocate: someone who speaks for developers inside a company and for the product outside.
  • Sample app: a small working program that shows the right way to use an API.
  • SDK: software development kit, the libraries and tools for building on a platform.
  • Onboarding: the first steps a new developer takes, from signup to a working call.

What to study, in order

  1. Follow another project's getting-started guide with a stopwatch and record every stumble.
  2. Build a small sample app against a public API and write its tutorial.
  3. Give a ten-minute talk or screencast on it, then collect questions.
  4. Triage a project's open questions into themes and propose three fixes.
  5. Learn to write an honest bug report that a maintainer can act on.

Related tags

#technical-writing #api-design #open-source-community #documentation

You are not logged in, so this goes up anonymously: no account, no name and no address is stored with it, and it may carry no link and no image. Log in or join to post under your name. Our web server's logs keep the address and time of every request for up to 14 days; to keep yours out of them, use Tor. To reach the staff in confidence, use the drop. Sign as a returning source (a key kept only in this browser)

Sending takes a few seconds here: your browser first works out a proof of work against spam.

Reply