Api Writer

API Writer | Developer Documentation (w/m/d)

An der Entwicklung von otto.de sind viele Expert*innen aus unterschiedlichen fachlichen Kontexten und in unterschiedlichen Rollen beteiligt. Um Wissen und Daten bestmöglich auszutauschen, sind APIs aus unserer IT-Landschaft nicht wegzudenken. Als API Writer leistest du einen entscheidenden Beitrag dazu, diese Schnittstellen verständlich und nutzerfreundlich zu dokumentieren und an zentraler Stelle verfügbar zu machen. Mit dieser Dokumentation stellen wir eine gute API-Experience sicher und machen so auch unsere interne Zusammenarbeit am Produkt viel effizienter. Zusätzlich zur API-Dokumentation unterstützt du unsere Entwicklungsteams auch mit weiterer technischer Dokumentation aus dem Technical Writing Portfolio.

Wir möchten ganz offen sein: Technical Writing ist noch „frisch“ bei uns, und mit einem API Writer bzw. Technical Writer zusammenzuarbeiten ist für viele Kolleg*innen noch Neuland. Aber: Jeder bekommt direkt leuchtende Augen, wenn eine API ohne große Rückfragen genutzt werden kann, Informationen sinnvoll in Objekten zusammengefasst sind oder eine einheitliche und sinnvolle Benennung gefunden wurde.

Viele sprechen von „Homeoffice“ - wir von „hybrid oder mobile Work“: Wie wir zusammenarbeiten und ein gutes Gleichgewicht aus mobilem Arbeiten und Präsenz auf unserem Campus in Hamburg leben können, entscheiden wir gemeinsam im Team und mit unseren Führungskräften.
- Dein ImpactDein Arbeitsalltag bei OTTO wird eine bunte und spannende Mischung aus folgenden Aufgaben sein:

- Du begleitest ein oder mehrere Entwicklungsteams bei der Erstellung und Pflege technischer Dokumentation in Deutsch und Englisch während des gesamten Entwicklungsprozesses. API-Dokumentation ist hier dein Steckenpferd und GitHub deine Komfortzone.
- Du erfragst mit Leichtigkeit alle relevanten Informationen bei Entwickler*i_nnen, Produktmanager*i_nnen und Nutzer*innen, die du für deine Arbeit brauchst. Dabei hinterfragst du Informationen und bist wissbegierig, auch alles zu verstehen.
- Du schaffst es, komplexe Informationen einfach zu vermitteln und gut konsumierbar zu strukturieren.
- Du bringst Funktionsweisen inhaltlich auf den Punkt und setzt sie mit Dokumentationen wie API-Dokumentation, READMEs, Runbooks oder User Guides ins perfekte Rampenlicht.
- Du bereitest Informationen zielgruppengerecht auf und hast dabei immer deine Nutzer*i_nnen im Blick. Auf Developer Experience und effiziente Arbeitsabläufe für Entwickler*_innen achtest du dabei besonders.
- Du beschäftigst dich intensiv mit den relevanten Inhalten. So kannst du genau einschätzen, was eher knifflig ist und besondere Beachtung finden muss.
- Du findest und bedienst für deine Arbeit geeignete Kommunikationskanäle.
- Du stimmst dich mit Technical Writern anderer Teams ab, um ein einheitliches Gesamtbild zu generieren und eine gemeinsame Sprache zu etablieren.
- An dieser Stelle könnten jetzt Infos zu deinem zukünftigen Team oder fachlichem Arbeitskontext stehen. Das sparen wir hier ganz bewusst aus, weil wir mehrere Stellen besetzen wollen und anhand deiner Erfahrung und deiner Präferenzen gemeinsam mit dir schauen möchten, wo du gut aufgehoben sein könntest. Damit du nicht ganz im Dunkeln tappst: Du wirst auf jeden Fall ein Teil eines unserer agilen Softwareentwicklungsteams sein, die z. B. im Kontext Suche oder Produktdaten verortet sind oder wichtige technische Komponenten bereitstellen, um otto.de 24/7 am Laufen zu halten.- Dein ProfilMust have
- Du hast Erfahrung im Bereich API-Dokumentation, insbesondere mit OpenAPI oder AsyncAPI.
- Du hast fundierte Kenntnisse in der Erstellung qualitativ hochwertiger, technischer Dokumentation.
- GitHub und du, ihr seid „best buddies“.
- Komplexe Sachverhalte und Konzepte erfasst du schnell und kannst sie anwenderfreundlich vermitteln. Du bist empathisch, kommunikativ und neugierig.
- Du zeichnest dich durch eine hohe Eigenmotivation, Initiative sowie selbstständige Arbeitsweise aus.
- Dein Sprachniveau: Deutsch C2 (annähernd muttersprachlich) und Englisch C1 (fachkundige Sprachverwendung).

Nice-to-have
- Erfahrung mit Command Line Tools sowie Affinität und Lernbereitschaft zu Entwicklungstools
- Erfahrung in der Zusammenarbeit mit agilen Entwicklungsteams
- Erfahrung im E-Commerce
- Erfahrung mit Confluence
- Deine Benefits- Work-Life-Balance
Hybrides Arbeitsmodell, Activity Based Working, flexible Arbeitszeiten (Gleitzeit), 37,5h-Woche, 30 Urlaubstage, Workation
- und Sabbatical-Option
- Vergütung & Zusatzangebote
Urlaubs
- und Weihnachtsgeld, 15 % Personalrabatt sowie zahlreiche Benefits & Mitarbeiterangebote (z. B. Events, Reisen), Altersvorsorgemodelle, Möglichkeit zur Kapitalbeteiligung, Relocation-Angebot
- Fachliche & persönliche Entwicklung
2-wöchiges Onboarding, Weiterbildungsangebote wie z. B. die OTTO-Akademie, digitale Lernplattformen - u. a. Masterplan, Coaching & Mentoring, Hospitationen, Entwicklungsprogramme, Führ