mirror
/
tiangolo.fastapi
mirror of https://github.com/tiangolo/fastapi
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
5952 Commits
26 Branches
212 Tags
186 MiB
 
Tree: c5c09a182f
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'c5c09a182f'
${ noResults }
tiangolo.fastapi/docs/de/docs/help-fastapi.md

16 KiB
Raw Blame History

FastAPI helfen – Hilfe erhalten

Mögen Sie FastAPI?

Möchten Sie FastAPI, anderen Benutzern und dem Autor helfen?

Oder möchten Sie Hilfe zu FastAPI erhalten?

Es gibt sehr einfache Möglichkeiten zu helfen (einige erfordern nur ein oder zwei Klicks).

Und es gibt auch mehrere Möglichkeiten, Hilfe zu bekommen.

Newsletter abonnieren

Sie können den (unregelmäßigen) FastAPI and friends-Newsletter{.internal-link target=_blank} abonnieren, um über folgende Themen informiert zu bleiben:

  • Neuigkeiten über FastAPI und Freunde 🚀
  • Anleitungen 📝
  • Funktionen ✨
  • Breaking Changes 🚨
  • Tipps und Tricks ✅

FastAPI auf Twitter folgen

Folgen Sie @fastapi auf Twitter, um die neuesten Nachrichten über FastAPI zu erhalten. 🐦

FastAPI auf GitHub einen Stern geben

Sie können FastAPI auf GitHub „starren“ (klicken Sie auf den Stern-Button oben rechts): https://github.com/fastapi/fastapi. ⭐️

Durch das Hinzufügen eines Sterns können andere Benutzer es leichter finden und sehen, dass es für andere bereits nützlich war.

Beobachten Sie das GitHub-Repository für Releases

Sie können FastAPI auf GitHub „beobachten“ (klicken Sie auf den „watch“-Button oben rechts): https://github.com/fastapi/fastapi. 👀

Dort können Sie „Releases only“ auswählen.

Auf diese Weise erhalten Sie Benachrichtigungen (per E-Mail), wenn es ein neues Release (eine neue Version) von FastAPI mit Bugfixes und neuen Funktionen gibt.

Mit dem Autor vernetzen

Sie können sich mit mir (Sebastián Ramírez / tiangolo), dem Autor, verbinden.

Sie können:

  • Mir auf GitHub folgen.
    • Andere Open-Source-Projekte sehen, die ich erstellt habe und die Ihnen helfen könnten.
    • Mir folgen, um zu sehen, wann ich ein neues Open-Source-Projekt erstelle.
  • Mir auf Twitter folgen oder Mastodon.
    • Mir mitteilen, wie Sie FastAPI verwenden (ich höre das gerne).
    • Erfahren, wann ich Ankündigungen mache oder neue Tools veröffentliche.
    • Sie können auch @fastapi auf Twitter folgen (ein separates Konto).
  • Mir auf LinkedIn folgen.
    • Erfahren, wann ich Ankündigungen mache oder neue Tools veröffentliche (obwohl ich Twitter häufiger verwende 🤷‍♂).
  • Lesen, was ich schreibe (oder mir folgen) auf Dev.to oder Medium.
    • Andere Ideen, Artikel lesen und mehr über die von mir erstellten Tools erfahren.
    • Mir folgen, um zu lesen, wenn ich etwas Neues veröffentliche.

Über FastAPI tweeten

Tweeten Sie über FastAPI und teilen Sie mir und anderen mit, warum es Ihnen gefällt. 🎉

Ich höre gerne, wie FastAPI verwendet wird, was Ihnen daran gefallen hat, in welchem Projekt/Unternehmen Sie es verwenden, usw.

Für FastAPI abstimmen

Anderen bei Fragen auf GitHub helfen

Sie können versuchen, anderen bei ihren Fragen zu helfen:

In vielen Fällen kennen Sie möglicherweise bereits die Antwort auf diese Fragen. 🤓

Wenn Sie vielen Menschen bei ihren Fragen helfen, werden Sie offizieller FastAPI-Experte{.internal-link target=_blank}. 🎉

Denken Sie daran, der wichtigste Punkt ist: Versuchen Sie, freundlich zu sein. Die Leute bringen ihre Frustrationen mit und fragen in vielen Fällen nicht auf die beste Art und Weise, aber versuchen Sie dennoch so gut wie möglich, freundlich zu sein. 🤗

Die FastAPI-Community soll freundlich und einladend sein. Akzeptieren Sie gleichzeitig kein Mobbing oder respektloses Verhalten gegenüber anderen. Wir müssen uns umeinander kümmern.

So helfen Sie anderen bei Fragen (in Diskussionen oder Issues):

Die Frage verstehen

  • Prüfen Sie, ob Sie verstehen können, was der Zweck und der Anwendungsfall der fragenden Person ist.

  • Überprüfen Sie dann, ob die Frage (die überwiegende Mehrheit sind Fragen) klar ist.

  • In vielen Fällen handelt es sich bei der gestellten Frage um eine Lösung, die der Benutzer sich vorstellt, aber es könnte eine bessere Lösung geben. Wenn Sie das Problem und den Anwendungsfall besser verstehen, können Sie eine bessere Alternativlösung vorschlagen.

  • Wenn Sie die Frage nicht verstehen können, fragen Sie nach weiteren Details.

Das Problem reproduzieren

In den meisten Fällen und bei den meisten Fragen gibt es etwas in Bezug auf den Originalcode der Person.

In vielen Fällen wird nur ein Fragment des Codes gepostet, aber das reicht nicht aus, um das Problem zu reproduzieren.

  • Sie können die Person bitten, ein minimales, reproduzierbares Beispiel bereitzustellen, welches Sie kopieren, einfügen und lokal ausführen können, um den gleichen Fehler oder das gleiche Verhalten zu sehen, das die Person sieht, oder um ihren Anwendungsfall besser zu verstehen.

  • Wenn Sie in Geberlaune sind, können Sie ein solches Beispiel selbst erstellen, nur basierend auf der Beschreibung des Problems. Denken Sie jedoch daran, dass dies viel Zeit in Anspruch nehmen kann und dass es besser sein kann, zunächst um eine Klärung des Problems zu bitten.

Lösungen vorschlagen

  • Nachdem Sie die Frage verstanden haben, können Sie eine mögliche Antwort geben.

  • In vielen Fällen ist es besser, das zugrunde liegende Problem oder den Anwendungsfall zu verstehen, da es möglicherweise einen besseren Weg zur Lösung gibt als das, was die Person versucht.

Um Schließung bitten

Wenn sie antworten, besteht eine hohe Chance, dass Sie ihr Problem gelöst haben. Herzlichen Glückwunsch, Sie sind ein Held! 🦸

  • Wenn es tatsächlich das Problem gelöst hat, können Sie sie darum bitten:

    • In GitHub-Diskussionen: den Kommentar als Antwort zu markieren.
    • In GitHub-Issues: Das Issue zu schließen.

Das GitHub-Repository beobachten

Sie können FastAPI auf GitHub „beobachten“ (klicken Sie auf den „watch“-Button oben rechts): https://github.com/fastapi/fastapi. 👀

Wenn Sie dann „Watching“ statt „Releases only“ auswählen, erhalten Sie Benachrichtigungen, wenn jemand ein neues Issue eröffnet oder eine neue Frage stellt. Sie können auch spezifizieren, dass Sie nur über neue Issues, Diskussionen, PRs usw. benachrichtigt werden möchten.

Dann können Sie versuchen, bei der Lösung solcher Fragen zu helfen.

Fragen stellen

Sie können im GitHub-Repository eine neue Frage erstellen, zum Beispiel:

  • Stellen Sie eine Frage oder bitten Sie um Hilfe mit einem Problem.
  • Schlagen Sie eine neue Funktionalität vor.

Hinweis: Wenn Sie das tun, bitte ich Sie, auch anderen zu helfen. 😉

Pull Requests prüfen

Sie können mir helfen, Pull Requests von anderen zu überprüfen.

Noch einmal, bitte versuchen Sie Ihr Bestes, freundlich zu sein. 🤗

Hier ist, was Sie beachten sollten und wie Sie einen Pull Request überprüfen:

Das Problem verstehen

  • Stellen Sie zunächst sicher, dass Sie das Problem verstehen, welches der Pull Request zu lösen versucht. Möglicherweise gibt es eine längere Diskussion dazu in einer GitHub-Diskussion oder einem GitHub-Issue.

  • Es besteht auch eine gute Chance, dass der Pull Request nicht wirklich benötigt wird, da das Problem auf andere Weise gelöst werden kann. Dann können Sie das vorschlagen oder danach fragen.

Keine Panik wegen des Stils

  • Machen Sie sich keine Sorgen über Dinge wie den Stil von Commit-Nachrichten. Ich werde den Commit zusammenführen und manuell anpassen.

  • Also keine Sorgen über Stilregeln, es gibt bereits automatisierte Tools, die das überprüfen.

Und wenn es irgendein anderer Stil- oder Konsistenzbedarf gibt, werde ich direkt danach fragen oder zusätzliche Commits mit den erforderlichen Änderungen hinzufügen.

Den Code überprüfen

  • Prüfen und lesen Sie den Code, fragen Sie sich, ob er Sinn macht, führen Sie ihn lokal aus und testen Sie, ob er das Problem tatsächlich löst.

  • Schreiben Sie dann einen Kommentar und berichten, dass Sie das getan haben. So weiß ich, dass Sie ihn wirklich überprüft haben.

/// info | Hinweis

Leider kann ich PRs, nur weil sie von mehreren gutgeheißen wurden, nicht einfach vertrauen.

Es ist mehrmals passiert, dass es PRs mit drei, fünf oder mehr Zustimmungen gibt, wahrscheinlich weil die Beschreibung ansprechend ist, aber wenn ich die PRs überprüfe, sind sie tatsächlich fehlerhaft, haben einen Bug, oder lösen das Problem nicht, welches sie behaupten, zu lösen. 😅

Daher ist es wirklich wichtig, dass Sie den Code wirklich lesen und ausführen und mir in den Kommentaren mitteilen, dass Sie dies getan haben. 🤓

///

  • Wenn der PR in irgendeiner Weise vereinfacht werden kann, können Sie danach fragen, aber es gibt keinen Grund, zu wählerisch zu sein. Es gibt viele subjektive Standpunkte (und ich habe auch meinen eigenen 🙈), also ist es besser, wenn man sich auf die grundlegenden Dinge konzentriert.

Tests

  • Helfen Sie mir zu überprüfen, dass der PR Tests hat.

  • Überprüfen Sie, dass diese Tests vor dem PR fehlschlagen. 🚨

  • Überprüfen Sie dann, dass diese Tests nach dem PR bestanden werden. ✅

  • Viele PRs haben keine Tests. Sie können den Autor daran erinnern, Tests hinzuzufügen, oder Sie können sogar selbst einige Tests vorschlagen. Das ist eines der Dinge, die am meisten Zeit in Anspruch nehmen, und Sie können dabei viel helfen.

  • Kommentieren Sie auch hier anschließend, was Sie versucht haben, sodass ich weiß, dass Sie es überprüft haben. 🤓

Einen Pull Request erstellen

Sie können zum Quellcode mit Pull Requests beitragen{.internal-link target=_blank}, zum Beispiel:

  • Um einen Tippfehler zu beheben, den Sie in der Dokumentation gefunden haben.
  • Um einen Artikel, ein Video oder einen Podcast über FastAPI zu teilen, den Sie erstellt oder gefunden haben, indem Sie diese Datei bearbeiten.
    • Stellen Sie sicher, dass Sie Ihren Link am Anfang des entsprechenden Abschnitts einfügen.
  • Um zu helfen, die Dokumentation in Ihre Sprache zu übersetzen{.internal-link target=_blank}.
    • Sie können auch dabei helfen, die von anderen erstellten Übersetzungen zu überprüfen (Review).
  • Um neue Dokumentationsabschnitte vorzuschlagen.
  • Um ein bestehendes Problem/Bug zu beheben.
    • Stellen Sie sicher, dass Sie Tests hinzufügen.
  • Um eine neue Funktionalität hinzuzufügen.
    • Stellen Sie sicher, dass Sie Tests hinzufügen.
    • Stellen Sie sicher, dass Sie Dokumentation hinzufügen, falls das notwendig ist.

FastAPI pflegen

Helfen Sie mir, FastAPI zu pflegen! 🤓

Es gibt viel zu tun, und das meiste davon können SIE tun.

Die Hauptaufgaben, die Sie jetzt erledigen können, sind:

Diese beiden Aufgaben sind die Dinge, die am meisten Zeit verbrauchen. Das ist die Hauptarbeit bei der Wartung von FastAPI.

Wenn Sie mir dabei helfen können, helfen Sie mir, FastAPI zu pflegen und stellen sicher, dass es weiterhin schneller und besser voranschreitet. 🚀

Am Chat teilnehmen

Treten Sie dem 👥 Discord-Chat-Server 👥 bei und treffen Sie sich mit anderen Mitgliedern der FastAPI-Community.

/// tip | Tipp

Bei Fragen stellen Sie sie in GitHub-Diskussionen, dort besteht eine viel größere Chance, dass Sie Hilfe von den FastAPI-Experten{.internal-link target=_blank} erhalten.

Nutzen Sie den Chat nur für andere allgemeine Gespräche.

///

Den Chat nicht für Fragen verwenden

Bedenken Sie, dass Sie in Chats, die „freie Konversation“ erlauben, leicht Fragen stellen können, die zu allgemein und schwer zu beantworten sind, sodass Sie möglicherweise keine Antworten erhalten.

Auf GitHub hilft Ihnen die Vorlage dabei, die richtige Frage zu stellen, sodass Sie leichter eine gute Antwort erhalten können, oder sogar das Problem selbst lösen, bevor Sie überhaupt fragen. Und auf GitHub kann ich sicherstellen, dass ich immer alles beantworte, auch wenn es einige Zeit dauert. Persönlich kann ich das mit den Chat-Systemen nicht machen. 😅

Unterhaltungen in den Chat-Systemen sind auch nicht so leicht durchsuchbar wie auf GitHub, sodass Fragen und Antworten möglicherweise im Gespräch verloren gehen. Und nur die auf GitHub machen einen FastAPI-Experten{.internal-link target=_blank}, Sie werden also höchstwahrscheinlich mehr Aufmerksamkeit auf GitHub erhalten.

Auf der anderen Seite gibt es Tausende von Benutzern in den Chat-Systemen, sodass die Wahrscheinlichkeit hoch ist, dass Sie dort fast immer jemanden zum Reden finden. 😄

Den Autor sponsern

Wenn Ihr Produkt/Firma auf FastAPI angewiesen ist oder in Zusammenhang steht und Sie seine Benutzer erreichen möchten, können Sie den Autor (mich) über GitHub-Sponsoren unterstützen. Je nach Stufe können Sie einige zusätzliche Vorteile erhalten, wie z.B. ein Abzeichen in den Docs. 🎁

Danke! 🚀