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

Otto (GmbH & Co KG)

  • Hamburg
  • Veröffentlicht am: 12. Oktober 2024
Jobbeschreibung
OTTO ist eines der erfolgreichsten E-Commerce-Unternehmen Europas. Mit mehr als 10 Millionen Artikeln von über 7.000 Marken gehört otto.de heute zu den führenden deutschen Onlineshopping-Plattformen. Als Marktplatz öffnen wir uns stetig für weitere Marken und Partner und wachsen so immer weiter. Ausruhen? Nicht unser Ding! Deins auch nicht? Dann komm an Board – und gestalte mit uns die Zukunft des E-Commerce.

Vielfalt gehört zu uns, wie die Elbe zu Hamburg: Wir stehen für Offenheit, Respekt und Toleranz, ohne Wenn und Aber. Lass uns gemeinsam die Segel setzen – unabhängig davon, woher du kommst, wen du liebst oder woran du glaubst. Denn du bist einmalig und genau das suchen wir.

Bei uns kannst du Ideen einbringen und Projekte vorantreiben, dich in Netzwerken für dein Herzensthema engagieren und unsere Unternehmenskultur aktiv mitgestalten. Dinge ausprobieren, neu denken, innovativ sein, über sich hinauswachsen – das ist unser Mindset. Lass uns gemeinsam etwas Großes erreichen. Egal ob du auf dem Campus oder zu Hause arbeitest. Mach auch du OTTO zu deinem Playground.

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“: Du kannst bis zu 50 % deiner monatlichen Arbeitszeit remote arbeiten. Unsere Teams entscheiden dabei gemeinsam mit ihrer Führungskraft, wie sie das Gleichgewicht aus Präsenzzeiten vor Ort und mobilem Arbeiten gestalten.


Dein 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*innen, Produktmanager*innen 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*innen 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.


Must 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

  • Work-Life-Balance
    Hybrides Arbeitsmodell mit bis zu 50% remote work im Monat, 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ührungs- und Expertenlaufbahn, Teilnahme-Option an Fachkonferenzen
  • Gesundheit & Wohlbefinden
    Über 30 Betriebssportarten, Meditationsraum, Achtsamkeits- und Stressmanagementkurse, Angebote für Eltern, betriebsärztliche & psychosoziale Beratung
  • Kultur & Zusammenarbeit
    Communities & Netzwerke, Coworking & Social Spaces, Leading Principles, regelmäßige Mitarbeiterbefragungen, kostenfreie Heißgetränke und vielfältiges – auch veganes – Essensangebot, Paketshop
  • Mobilität
    Deutschlandticket für 30 €, kostenfreie Parkplätze, e-Ladesäulen, StadtRAD-Stationen

& viele Benefits mehr!

Mehr