Die API-Dokumentation dient als Nachschlagewerk; eine Entwicklerpräsentation dient der Einarbeitung. Ihre Dokumentation listet zwar jeden Endpunkt, jeden Parameter und jeden Antwortcode auf, doch Entwickler benötigen zunächst ein mentales Modell: Was macht die API, wie funktioniert die Authentifizierung und wie führt man einen ersten Aufruf durch? Mit Gamma können Sie Ihre Dokumentationsquelle verknüpfen oder den Inhalt einfügen und den KI-Agenten innerhalb weniger Minuten das komplexe Referenzmaterial in eine übersichtliche, visuelle Entwicklerpräsentation mit Konzepten, Abläufen und Beispielaufrufen umwandeln lassen.
Die Herausforderung liegt in der Reihenfolge. Die Dokumentation ist auf das Nachschlagen ausgelegt – mit alphabetisch geordneten Endpunkten und umfassenden Parametern –, während eine Präsentation in einer Reihenfolge vermitteln muss, die schrittweise aufbaut. Man kann einen Entwickler nicht einarbeiten, indem man das Referenzhandbuch von vorne bis hinten durchliest. Der Gamma-Agent liest Ihre Dokumentation, erkundigt sich, wer die Integration vornimmt und was dabei erreicht werden soll, und gestaltet das Material zu einem Vortrag um, der Entwickler zu ihrem ersten erfolgreichen Aufruf führt.
Eine überzeugende Entwicklerpräsentation macht aus Referenzdokumenten verständliche Informationen:
Erläutert gleich zu Beginn, was die API leistet und welches Problem sie löst
Behandelt das Thema Authentifizierung gleich zu Beginn, da ohne sie nichts funktioniert
Zeigt die Kernkonzepte und das Ressourcenmodell vor den Endpunkten
Führt durch einen ersten Anruf mit einer konkreten Anfrage und Antwort
Hebt die wichtigsten Endpunkte hervor, die Entwickler tatsächlich am häufigsten nutzen werden
Verweist auf die vollständige Dokumentation für alles Weitere
Die besten Entwicklerpräsentationen bringen das Publikum dazu zu denken: „Ich verstehe, wie man das nutzt“, und nicht: „Ich habe jeden Endpunkt gesehen.“
Verbinden Sie das Tool mit dem Ort, an dem sich Ihre Dokumente befinden – sei es Confluence, ein Dokumenten-Repo über GitHub oder Notion – und Gamma ruft die Inhalte direkt ab, ganz ohne Kopieren und Einfügen. Arbeiten Sie lieber mit Dateien? Fügen Sie Ihre Referenzdokumente ein oder laden Sie den Markdown-Code hoch. So oder so: Gamma liest das Material und erkennt, dass es sich um API-Dokumentation handelt. Das Verbinden einer Quelle dauert weniger als eine Minute und ermöglicht eine schnelle Aktualisierung der Präsentation, sobald sich die API ändert.
Gammas Berater ermittelt, wer die Integration vornimmt und was damit erreicht werden soll, liest die Dokumentation durch und ordnet sie in einen Ablauf, der folgende Themen vermittelt: Überblick, Authentifizierung, Konzepte, erster Aufruf, wichtige Endpunkte und Ressourcen. Das Referenzmaterial wird so zu einer Erzählung, die zum Verständnis beiträgt.
Gamma wandelt Ihre Beispielanfragen automatisch in übersichtliche Code-Blöcke, Ihre Authentifizierungs- und Anforderungsabläufe in Diagramme und Ihr Ressourcenmodell in anschauliche Grafiken um. Anstelle einer Flut von Referenztext sehen Entwickler die Konzepte übersichtlich dargestellt, sodass sie leicht nachvollziehbar sind.
Verbinden Sie Ihre Dokumentquelle oder halten Sie den Referenzinhalt zum Einfügen bereit. Eine Übersicht, die Authentifizierung und einige wichtige Endpunkte bieten dem Agenten die besten Voraussetzungen für seine Arbeit.
Öffnen Sie gamma.app und beginnen Sie mit dem Eingabefeld. Verknüpfen Sie Ihre Dokumente oder fügen Sie den Inhalt ein und geben Sie dann Ihre Anfrage ein, zum Beispiel: „Wandeln Sie diese API-Dokumentation in eine Einführungspräsentation für Entwickler um, die die Authentifizierung, Kernkonzepte und einen ersten Aufruf behandelt – für Ingenieure, die unsere API integrieren.“ Geben Sie dem Agenten ein oder zwei kurze Antworten, und schon macht er sich an die Arbeit.
Gamma schlägt einen Ablaufplan vor. Eine typische Entwicklerpräsentation verläuft wie folgt:
Was die API leistet und wann man sie einsetzt
Authentifizierung und Abrufen von Anmeldedaten
Kernkonzepte und das Ressourcenmodell
Ihre erste Anfrage und Antwort
Wichtige Endpunkte und gängige Arbeitsabläufe
Fehler, Einschränkungen und bewährte Vorgehensweisen
Vollständige Dokumentation und Ressourcen
Ordnen Sie Abschnitte neu an, fügen Sie sie hinzu oder streichen Sie sie, um sie an Ihre Zielgruppe anzupassen. Müssen Partner zunächst ihre Anmeldedaten eingeben? Verschieben Sie diesen Abschnitt nach oben.
Gamma erstellt eine vollständige, formatierte Entwicklerpräsentation mit Ihren Code-Blöcken, Ablaufdiagrammen und einem durchgängig einheitlichen Erscheinungsbild. Für Partner- oder Launch-Briefings nutzt der Max-Modus die leistungsstärksten verfügbaren Modelle, um das Ergebnis noch weiter zu verfeinern.
Das Layout ist bereits fertiggestellt, sodass jedes Konzept optimal zur Geltung kommt. Wenn Sie einen Code-Block oder ein Diagramm genau an einer bestimmten Stelle platzieren möchten, wechseln Sie in den Freiform-Bearbeitungsmodus und positionieren Sie es präzise. Möchten Sie die Änderung lieber beschreiben? Nutzen Sie die KI-Bearbeitung, wählen Sie ein beliebiges Element aus und sagen Sie Gamma, was es tun soll, z. B. „Zeige den Authentifizierungsablauf als Diagramm an“ oder „Heb die erforderlichen Parameter hervor“. Bringen Sie jede Überschrift auf den einen entscheidenden Gedanken auf den Punkt.
Halten Sie eine Live-Präsentation, teilen Sie einen interaktiven Weblink, über den Entwickler die Präsentation erneut aufrufen können, oder exportieren Sie sie in PowerPoint, PDF oder Google Slides. Ihr Code, Ihre Diagramme und Ihre Formatierung bleiben dabei erhalten, sodass Entwickler das Material in dem von ihnen bevorzugten Format erhalten.
Gamma vs. direkte Darstellung aus den Dokumenten
Format: Dokumente sind übersichtlich angeordnet; eine Präsentation benötigt eine Reihenfolge, die den Lernstoff vermittelt
Pace: Referenzmaterial überfüllt den Raum; Gamma stellt genau das bereit, was Entwickler als Erstes benötigen
Visuelle Darstellung: Dokumente sind sehr textlastig; Gamma wandelt Abläufe und Konzepte in Diagramme um
Ganz ehrlich: Behalten Sie Ihre API-Dokumentation als umfassendes Nachschlagewerk bei – genau dafür ist sie da. Wenn Sie Entwickler live einarbeiten, lassen Sie Gamma die Dokumentation in eine lehrreiche Präsentation umwandeln und verweisen Sie für Details auf das vollständige Nachschlagewerk.
Gamma vs. PowerPoint
Quelle: PowerPoint startet mit einer leeren Seite; Gamma liest Ihre Dokumente oder die angeschlossene Quelle direkt ein
Aktualisierungen: Wenn sich die API ändert, muss dies in PowerPoint manuell vorgenommen werden; in Gamma können Sie die Daten schnell aus der Quelle neu generieren
Gestaltung: Die Qualität von PowerPoint hängt von Ihnen ab; Gamma bleibt konsistent
Die ehrliche Einschätzung: Mit PowerPoint haben Sie die volle Kontrolle über eine maßgeschneiderte Präsentation. Wenn Sie Dokumentationen schnell in eine Einführungspräsentation umwandeln möchten, sind Sie mit Gamma schneller am Ziel, und Sie können die Datei jederzeit wieder nach PowerPoint exportieren.
Das mentale Modell steht im Vordergrund. Entwickler müssen zunächst die Struktur der API verstehen, bevor sie sich mit den Endpunkten befassen.
Kümmern Sie sich frühzeitig um die Authentifizierung. Solange die Authentifizierung nicht erfolgt ist, funktioniert nichts anderes – also lassen Sie diesen Punkt nicht untergehen.
Zeigen Sie einen echten ersten Aufruf. Eine konkrete Anfrage und Antwort vermittelt mehr als eine Parametertabelle.
Stellen Sie nicht jeden Endpunkt vor. Heben Sie die wenigen hervor, die von den Entwicklern am häufigsten genutzt werden, und verweisen Sie auf die übrigen.
Halten Sie die vollständige Referenz bereit. Verweisen Sie für ausführliche Informationen auf die Dokumentation, anstatt alles hier unterzubringen.
Ja. Verbinden Sie Confluence, ein GitHub-Docs-Repo, Notion oder wo auch immer sich Ihre Dokumente befinden, und Gamma ruft die Inhalte direkt ab. Sie können das Referenzmaterial auch einfügen, wenn Sie dies bevorzugen.
Ja. Gamma stellt Code in übersichtlichen, gut lesbaren Blöcken dar. Achten Sie darauf, dass die von Ihnen gezeigten Beispiele auf den Kern der Sache konzentriert sind, und nutzen Sie die KI-Bearbeitung, um erforderliche Parameter oder wichtige Zeilen hervorzuheben.
Gamma wandelt die von Ihnen beschriebenen Abläufe in übersichtliche Diagramme um. Verfeinern Sie diese mithilfe der Freiform-Bearbeitung oder bitten Sie den Agenten, einen Ablauf zu vereinfachen.
Wenn Ihre Dokumentquelle verbunden ist, bitten Sie Gamma, den Inhalt zu aktualisieren, oder speichern Sie ihn als Vorlage. Die Struktur bleibt erhalten; nur der Inhalt wird aktualisiert.
In Ihrer Dokumentation sind bereits alle Endpunkte beschrieben – sie ist jedoch lediglich zum Nachschlagen gedacht, nicht zur Einarbeitung. Verlinken Sie Ihre Dokumentation oder fügen Sie den Inhalt ein, teilen Sie Gamma Ihre Zielgruppe und deren Ziel mit, und lassen Sie den Agenten die Referenz in eine Schulungspräsentation mit Code und Diagrammen umwandeln. So bringen Sie Entwickler schnell zu ihrem ersten erfolgreichen Aufruf.
