rescoped.io

Dokumentations-Plattform für alle avodaq Open-Source-Projekte

Kunde

avodaq AG, Hamburg

Aufgabe im Team (1-2 Pers.)

Design Engineer (UI/UX-Designer, Frontend-Developer)

rescoped Dokumentation Coverbild

Projektbeschreibung

Die rescoped.io Dokumentationsplattform ist die zentrale Website für alle avodaq Open-Source-Projekte unter dem rescoped-Label. Die React-basierte Dokumentationsseite vereint technische Dokumentation mit ansprechender Präsentation für das rescoped Datagrid und zukünftige Komponenten, mit Fokus auf intuitive Bedienung und professionelle Optik zur Ansprache von Entwicklern und Entscheidungsträgern.

Kontext

Mit der Entwicklung des rescoped Datagrid entstand die Notwendigkeit einer professionellen Online-Dokumentation für die Veröffentlichung. Gleichzeitig sollte eine einheitliche Markenidentität für alle zukünftigen avodaq Open-Source-Projekte geschaffen werden. Die Plattform sollte technische Dokumentation und Marketing-Aspekte vereinen, um das Projekt erfolgreich in der Entwickler-Community zu positionieren.

Meine Aufgaben

Als Design Engineer entwickelte ich das komplette Projekt von der strategischen Konzeption bis zur finalen Veröffentlichung. In enger Zusammenarbeit mit allen beteiligten Stakeholdern übernahm ich:

  • Strategische Konzeption: Entwicklung eines strukturierten Fragenkatalogs mit anschließenden Stakeholder-Interviews, Marktforschung und Technologie-Evaluation
  • Framework-Evaluation: Umfassende Recherche und Bewertung verschiedener Tools und Libraries für Online-Dokumentation
  • Label-Entwicklung: Naming-Konzeption des “rescoped”-Markennamens mit Domain-Verfügbarkeitsprüfung und Corporate Design mit Logo, Farbschema und Typografie
  • Content Strategy: Entwicklung zielgruppenorientierter Sprache und Content-Optimierung für bessere Inklusivität und Lesbarkeit
  • Frontend-Entwicklung: Docusaurus-Implementierung, Custom Styling und Interactive Graphics mit Pixi.js
  • DevOps Integration: Zusammenarbeit mit dem CI/CD-Team für automatisierte Deployment-Pipelines

Praktisch jedes sichtbare Element — Formen, Farben, Größen, Abstände, Gruppierung, Anordnung, visuelle Hierarchien, Sprache, Tonalität, Animationen — wurde von mir konzipiert und umgesetzt.

Arbeitsprozess

Das Projekt wurde eigenverantwortlich entwickelt, wobei strukturierte Stakeholder-Interviews die Grundlage bildeten. Der Workflow umfasste Research und Marktanalyse als Framework-Evaluation, iterative Design-Entwicklung mit kontinuierlicher Stakeholder-Abstimmung, sowie die komplette technische Umsetzung von der Docusaurus-Integration bis zur finalen Veröffentlichung.

Herausforderungen

  • Marken-Entwicklung: Schaffung einer konsistenten Identität ohne bestehende Brand Guidelines
  • Framework-Anpassung: Verbesserung der Standard-Docusaurus-Styling-Optionen durch maßgeschneiderte Tailwind-Integration
  • Zielgruppen-Balance: Ansprache sowohl von Technical Decision Makern als auch Entwicklern
  • Content-Optimierung: Transformation technischer Fachsprache in verständliche, inklusive Dokumentation

Mein Impact

Design:

  • Nutzerfreundliche Dokumentation: Intuitive Navigation und strukturierte Informationsarchitektur
  • Visuell ansprechende Präsentation: Professionelles Erscheinungsbild auf Augenhöhe mit etablierten Projekten

Technisch:

  • Framework-Optimierung: Integration von Tailwind CSS für verbesserte Styling-Workflows
  • Content-Transformation: Überarbeitung technischer Dokumentation in verständliche, zielgruppengerechte Sprache

Konkret:

  • Hero-Animation: Pixi.js-basierte interaktive Grafik mit Mouse-Tracking für moderne Nutzerinteraktion, die als Differenzierungsmerkmal und Aufmerksamkeits-Generator dient
  • Naming-Strategie: “rescoped” als einprägsamer, domainverfügbarer Name mit klarem Bezug zum Entwicklungskontext, inklusive Sicherung der rescoped.io Domain als kurze, merkbare Adresse

Techstack

Konzept: Stakeholder-Interviews, Marktanalyse, Docusaurus-Evaluation

Projektstruktur: Docusaurus 2 (React), TypeScript

State Management: React Context, Hooks

Styling: Tailwind CSS (Custom Integration), SCSS

Testing: CI/CD Pipeline

Tools & Libraries: Pixi.js, WebGL, GSAP, MDX, Markdown

Projektergebnis

Das Projekt wurde erfolgreich umgesetzt, von der initialen Stakeholder-Einbindung über die komplette Entwicklung bis zur finalen Veröffentlichung. Durch die strukturierte Herangehensweise mit Interviews, Research und iterativer Abstimmung konnten alle Beteiligten erfolgreich in den Designprozess eingebunden werden.

Die rescoped.io Dokumentationsplattform etablierte sich als zentrale Anlaufstelle für alle avodaq Open-Source-Projekte. Das rescoped-Label positionierte sich als wiedererkennbare Marke für hochwertige Angular-Komponenten und legte den Grundstein für zukünftige Community-Projekte im Angular-Ökosystem.