Heim > Web-Frontend > js-Tutorial > Von Lamao LiveAPI: Erstellen einer äußerst praktischen API-Dokumentation (Teil II)

Von Lamao LiveAPI: Erstellen einer äußerst praktischen API-Dokumentation (Teil II)

Barbara Streisand
Freigeben: 2024-12-16 08:21:16
Original
398 Leute haben es durchsucht

In meinem vorherigen Beitrag habe ich erzählt, wie ein kleines Team von Teilzeitstudenten Lama2 entwickelt hat – ein Tool, das die API-Erfassung und -Ausführung vereinfacht.

Es wurde schnell zu einem wesentlichen Bestandteil unseres Workflows, aber als unsere API-Repositorys wuchsen, begann der manuelle Prozess von Lama2 an seine Grenzen zu stoßen.

Die Herausforderungen der Skalierung von Lama2

Als wir anfingen, bestand unser Team aus fünf Studenten, die Teilzeitarbeit und Studium unter einen Hut brachten.

Wir haben täglich 3-4 Stunden gearbeitet und dabei oft die Grenzen unserer begrenzten Fähigkeiten überschritten. Lama2 war nur eines von drei Projekten, die wir damals bauten.

Trotz unserer Einschränkungen wurde Lama2 bei Hacker News gut aufgenommen. Wir haben sogar einige frühe Befürworter des Produkts gewonnen. Für ein CLI-Tool und eine Nischensprache war das eine solide Antwort.

Die Versandfunktionen haben jedoch immer noch länger gedauert, als wir gehofft hatten. Als wir zum Wettbewerb bereit waren, war der Markt für API-Clients bereits überfüllt.

Etablierte Teams, die hauptberuflich an ähnlichen Produkten arbeiten, haben durch ihre harte Arbeit und Reichweite an Bedeutung gewonnen. Während Lama2 echte Probleme löste, löste es nicht die große Begeisterung aus, die wir uns vorgestellt hatten.

Wir haben erkannt, dass Lama2 mehr als nur Ausführungstools benötigt, um eine echte Wirkung zu erzielen.

Die Herausforderungen der Skalierung von Lama2

Als wir anfingen, bestand unser Team aus fünf Studenten, die Teilzeitarbeit und Studium unter einen Hut brachten.

Wir haben täglich 3-4 Stunden gearbeitet und dabei oft die Grenzen unserer begrenzten Fähigkeiten überschritten. Lama2 war nur eines von drei Projekten, die wir damals bauten.

Trotz unserer Einschränkungen wurde Lama2 bei Hacker News gut aufgenommen. Wir haben sogar einige frühe Befürworter des Produkts gewonnen. Für ein CLI-Tool und eine Nischensprache war das eine solide Antwort.

Die Versandfunktionen haben jedoch immer noch länger gedauert, als wir gehofft hatten. Als wir zum Wettbewerb bereit waren, war der Markt für API-Clients bereits überfüllt.

Etablierte Teams, die hauptberuflich an ähnlichen Produkten arbeiten, haben durch ihre harte Arbeit und Reichweite an Bedeutung gewonnen. Während Lama2 echte Probleme löste, löste es nicht die große Begeisterung aus, die wir uns vorgestellt hatten.

Wir haben erkannt, dass Lama2 mehr als nur Ausführungstools benötigt, um eine echte Wirkung zu erzielen.

Das Problem mit der manuellen API-Dokumentation

Selbst mit Lama2 war die Pflege großer API-Sammlungen eine Herausforderung. Anfangs schien es überschaubar zu sein, APIs für alle Dienste in einem einzigen Repository zu sammeln. Aber als wir auf vier Backends und Hunderte von APIs skalierten, wurde der Prozess überwältigend.

Wir wussten aus erster Hand, wie frustrierend es war, API-Änderungen manuell zu dokumentieren und zu synchronisieren. Und wir waren nicht allein – jeder Entwickler steht vor dieser Herausforderung, wenn er mit großen API-Sammlungen arbeitet.

Eine Vision für Automatisierung

Wir wussten, dass wir den Arbeitsablauf automatisieren mussten, um die API-Dokumentation mühelos und die Ausführung nahtlos zu gestalten. Unser Ziel war es, manuelle Schritte zu eliminieren und ein Tool zu schaffen, das:

  1. APIs automatisch dokumentieren, während der Code zusammengeführt wurde, ohne dass Meta-Tags usw. eingerichtet werden müssen.
  2. Halten Sie die Dokumentation bei jeder Änderung auf dem neuesten Stand
  3. Ermöglichen Sie jedem in der Organisation die einfache Ausführung von APIs

Unser Ziel war einfach: „Super-bequeme API-Dokumentation.“

Stellen Sie sich ein System vor, in dem:

  • Eingabe: Ein Repository-Link
  • Ausgabe: Vollständig dokumentierte APIs, die bei jedem Commit aktualisiert bleiben.

From Lamao LiveAPI: Building Super-Convenient API Documentation (Part II)

LiveAPI erstellen

Um diese Vision zum Leben zu erwecken, haben wir mit der Entwicklung von LiveAPI begonnen, einer Plattform mit den folgenden Hauptfunktionen:

  1. One-Click-Repository-Verbindung: Entwickler können ihr GitHub-, GitLab- oder Bitbucket-Repository mühelos verbinden.
  2. Automatisierte Dokumentationserstellung: Die Dokumentation wird automatisch für jeden Commit generiert, mit automatischer Synchronisierung, um sie auf dem neuesten Stand zu halten.
  3. Automatisierte Code-Snippets: Generieren Sie Code-Snippets für jede Sprache, damit Frontend-Entwickler schneller vorankommen können.
  4. Entwicklerfreundliche Erfahrung: Minimale Einrichtung, maximaler Komfort.
  5. LiveAPI Runner mit Privacy First:
    • Wir speichern niemals den Code Ihres Repositorys.
    • Mit unserer Logik extrahieren wir nur Routen und API-Validatoren.
    • Dieser gesamte Prozess läuft auf Ihrem privaten Server und stellt sicher, dass Ihre Daten niemals Ihre Infrastruktur verlassen.

Das Wort verbreiten

Nach monatelanger Arbeit ist LiveAPI fertig. Wir haben ein Tool entwickelt, das die Verwaltung und Dokumentation von APIs vereinfacht und es Teams ermöglicht, sich auf die Erstellung von Funktionen zu konzentrieren, anstatt sich mit der Dokumentation herumzuschlagen.

Jetzt ist es an der Zeit, das, was wir aufgebaut haben, mit der Welt zu teilen. Wenn Sie nach einem Super-Convenient API Docs Generation-Tool suchen, das Ihren Arbeitsablauf reibungsloser und Ihre Dokumentation müheloser macht, probieren Sie LiveAPI aus.

Schauen Sie sich das an und sehen Sie, wie es den API-Verwaltungsprozess Ihres Teams verändern kann.

Verbinde dich mit mir

Ich würde gerne Ihre Gedanken und Erfahrungen hören. Kontaktieren Sie mich auf X für einen frühen Zugriff und erfahren Sie, wie LiveAPI für Ihr Unternehmen funktionieren kann. Lassen Sie uns gemeinsam die API-Verwaltung einfacher machen!

Das obige ist der detaillierte Inhalt vonVon Lamao LiveAPI: Erstellen einer äußerst praktischen API-Dokumentation (Teil II). Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!

Quelle:dev.to
Erklärung dieser Website
Der Inhalt dieses Artikels wird freiwillig von Internetnutzern beigesteuert und das Urheberrecht liegt beim ursprünglichen Autor. Diese Website übernimmt keine entsprechende rechtliche Verantwortung. Wenn Sie Inhalte finden, bei denen der Verdacht eines Plagiats oder einer Rechtsverletzung besteht, wenden Sie sich bitte an admin@php.cn
Neueste Artikel des Autors
Beliebte Tutorials
Mehr>
Neueste Downloads
Mehr>
Web-Effekte
Quellcode der Website
Website-Materialien
Frontend-Vorlage