Schritt für Schritt
🤖 GitHub Copilot
GitHub
📘 Schritt für Schritt 📘 GitHub · GitHub Copilot↗ GitHub Copilot · Offizielle SeiteEinsteiger 🔄 Alltag & Business

Ein professionelles README mit GitHub Copilot erstellen

Nutze die KI-gestützte Autovervollständigung von Copilot, um eine klare Projektübersicht, eine Installationsanleitung und Anwendungsbeispiele zu erstellen, ohne eine einzige Zeile selbst schreiben zu müssen.

Am Ende dieser Anleitung hast du eine professionell aussehende README-Datei für dein Projekt fertiggestellt und dabei die clevere KI von GitHub Copilot genutzt, um den Text zu generieren, ohne selbst ganze Sätze tippen zu müssen. Das ist perfekt für alle, die neu beim Programmieren sind oder einfach eine saubere Beschreibung für ein Hobbyprojekt erstellen möchten, um es mit anderen zu teilen.

💡 Tipp: tippe auf die Nummer eines Schritts, wenn du ihn erledigt hast — ein grüner Haken erscheint und dein Browser merkt sich, wie weit du warst.

✅ Bevor du beginnst
  • Ein kostenloses GitHub-Konto: Du musst dich unter github.com anmelden, falls du noch keins hast. Hier befindet sich der Code deines Projekts in einem speziellen Online-Ordner.
  • Ein Repository, das du bearbeiten kannst: Das ist wie ein digitaler Ordner auf GitHub, der alle Codedateien deines Projekts enthält. Stelle sicher, dass du bereits eines erstellt und geöffnet hast.
  • Visual Studio Code (VS Code): Das ist ein beliebter, kostenlos herunterladbarer Texteditor, in dem du arbeiten wirst. Du bekommst ihn unter code.visualstudio.com.
  • Die GitHub Copilot-Erweiterung für VS Code: Das ist der KI-Helfer, den wir verwenden werden. Du musst ihn innerhalb von VS Code installieren. Obwohl es normalerweise eine kostenlose Testversion gibt, beachte bitte, dass nach Ablauf der Testphase in der Regel ein kostenpflichtiger Plan erforderlich ist.
  • Geschätzte Gesamtzeit: Diese Anleitung sollte dich etwa 15-20 Minuten kosten.
1

Öffne oder erstelle deine README-Datei

Dein erster Schritt ist, die spezielle README.md-Datei in deinem Projekt zu öffnen. Wenn sie noch nicht existiert, musst du sie erstellen. Der .md-Teil bedeutet, dass es sich um eine Markdown-Datei handelt, eine einfache Möglichkeit, Text zu formatieren (z. B. Überschriften, Listen oder fettgedruckte Wörter zu erstellen), die GitHub versteht.

Dazu schau dir den Explorer-Bereich auf der linken Seite deines VS Code-Fensters an – er zeigt alle deine Projektdateien und -ordner. Wenn du ihn nicht siehst, drücke Strg + Umschalt + E (unter Windows/Linux) oder Cmd + Umschalt + E (auf dem Mac), um ihn anzuzeigen.

Aktion: Klicke im Explorer-Bereich mit der rechten Maustaste auf den Hauptordner deines Projekts und wähle dann „Neue Datei“. Gib README.md genau wie gezeigt ein und drücke Enter. Was du siehst: Ein neues Eingabefeld für den Dateinamen erscheint im Explorer-Bereich. Was als Nächstes passiert: Die neue README.md-Datei wird als leeres Dokument im Haupteditorbereich von VS Code geöffnet. Wenn es anders aussieht: Wenn du bereits eine README.md-Datei hast, klicke einfach im Explorer-Bereich darauf, um sie zu öffnen, und lösche dann vorhandenen Text, wenn du für diese Anleitung neu beginnen möchtest.

💬 BeispielKlicke mit der rechten Maustaste auf deinen Projektordner, wähle *Neue Datei*, gib `README.md` ein und drücke `Enter`.

Du weißt, dass es funktioniert hat, wenn eine leere Datei namens README.md im Haupteditorbereich von VS Code erscheint, bereit für deine Eingabe.

2

Beginne deine Projektbeschreibung

Nachdem deine README.md-Datei geöffnet ist, bitten wir Copilot, uns beim Schreiben der Hauptbeschreibung zu helfen. GitHub Copilot verwendet eine sogenannte „Autovervollständigung“, die wie die Textvorhersage auf deinem Handy ist, aber viel intelligenter. Sie nutzt künstliche Intelligenz (KI), um basierend auf deinem Kontext zu erraten, was du als Nächstes schreiben möchtest.

Aktion: Platziere deinen blinkenden Cursor in der allerersten Zeile deiner README.md-Datei, gib eine kurze Überschrift für dein Projekt ein und drücke dann die Enter-Taste. Was du siehst: Nachdem du die Überschrift eingegeben hast, erscheint in der Regel direkt nach deinem Cursor ein ausgegrauter Vorschlag von Copilot. Was als Nächstes passiert: Copilot liest deine kurze Überschrift und beginnt automatisch, einen vollständigen Absatz vorzuschlagen, der dein Projekt beschreibt. Wenn der Vorschlag gut aussieht, drücke die Tab-Taste, um ihn zu akzeptieren. Wenn du eine andere Option möchtest, drücke Strg + Leertaste (unter Windows/Linux) oder Option + Leertaste (auf dem Mac), um verschiedene Vorschläge durchzugehen, bis du einen findest, der dir gefällt. Wenn es anders aussieht: Wenn Copilot nicht sofort einen Vorschlag macht, stelle sicher, dass die GitHub Copilot-Erweiterung aktiviert ist (überprüfe die untere rechte Ecke von VS Code auf ein kleines Copilot-Symbol). Du kannst auch versuchen, noch ein paar eigene Wörter einzugeben, bevor du erneut Enter drückst.

💬 BeispielGib `# Wetter-App` ein und drücke `Enter`. Copilot könnte dann vorschlagen: „Eine einfache Webanwendung, die aktuelle Wetterbedingungen für jede Stadt mithilfe von Echtzeitdaten der OpenWeatherMap API anzeigt.“

Du weißt, dass es funktioniert hat, wenn Copilot einen ausgegrauten Textvorschlag direkt in deinem Editor präsentiert und du eine Beschreibung durch Drücken von Tab akzeptiert hast.

3

Eine Installationsanleitung generieren

Die meisten Projekte benötigen Anweisungen zur Einrichtung. Copilot kann auch beim Generieren dieser häufigen Abschnitte helfen. Es errät oft intelligent, welche Programmiersprache dein Projekt aus anderen Dateien in deinem Repository verwendet, und schlägt relevante Befehle vor.

Aktion: Bewege deinen Cursor ein paar Zeilen nach unten (drücke Enter ein paar Mal, um etwas Platz zu schaffen), gib ## Installation ein, drücke Enter, dann gib eine kurze Aufforderung wie Führe den folgenden Befehl aus: ein und drücke Enter. Was du siehst: Deine neue Überschrift, gefolgt von deiner Aufforderung und dann ein ausgegrauter Vorschlag für einen Installationsbefehl. Was als Nächstes passiert: Copilot vervollständigt in der Regel automatisch einen Shell-Befehl (einen Befehl, den du in das Terminal eines Computers eingeben würdest), wie npm install (für JavaScript-Projekte) oder pip install -r requirements.txt (für Python-Projekte). Wenn es anders aussieht: Wenn der vorgeschlagene Befehl nicht zur Sprache oder zum Paketmanager deines Projekts (dem Tool, das Softwarekomponenten verwaltet) passt, lösche ihn einfach und gib eine spezifischere Aufforderung ein. Zum Beispiel: Installiere Python-Abhängigkeiten: wenn es npm install für dein Python-Projekt vorgeschlagen hat.

💬 BeispielGib `## Installation` ein, drücke `Enter`, dann `Führe den folgenden Befehl aus:` und `Enter`. Copilot könnte vorschlagen: `pip install -r requirements.txt`.

Du weißt, dass es funktioniert hat, wenn Copilot eine Befehlszeile zur Installation von Abhängigkeiten vorschlägt und du sie durch Drücken von Tab akzeptiert hast.

4

Ein Anwendungsbeispiel hinzufügen

Sobald ein Projekt installiert ist, müssen die Leute wissen, wie man es benutzt! Wir können einem ähnlichen Muster folgen, um Copilot dazu zu bringen, einen Befehl zum Starten deiner Anwendung zu generieren.

Aktion: Bewege deinen Cursor nach dem Installationsabschnitt ein paar Zeilen nach unten, gib ## Verwendung ein, drücke Enter, dann schreibe eine kurze Aufforderung wie Starte die App mit: und drücke Enter. Was du siehst: Deine neue Überschrift und Aufforderung, gefolgt von Copilots vorgeschlagenem Befehl. Was als Nächstes passiert: Copilot wird einen Befehl wie npm start oder python app.py vorschlagen, wiederum basierend darauf, was es über dein Projekt ableitet. Akzeptiere den passenden, indem du Tab drückst. Wenn es anders aussieht: Wenn der vorgeschlagene Befehl etwas daneben liegt, kannst du ihn akzeptieren und die Zeile dann manuell bearbeiten, um sie für dein Projekt korrekt zu machen. Du könntest auch eine kurze, einfache Beschreibung unter den Befehl hinzufügen, um zu klären, was er tut, z.B. „Dies startet den lokalen Server unter http://localhost:5000“.

💬 BeispielGib `## Verwendung` ein, drücke `Enter`, dann `Starte die App mit:` und `Enter`. Copilot könnte vorschlagen: `python app.py`.

Du weißt, dass es funktioniert hat, wenn Copilot einen Befehl anbietet, um dein Projekt zum Laufen zu bringen, und du ihn akzeptiert hast.

5

Eine Projektübersicht hinzufügen

Ein gutes README endet oft mit einer kurzen Zusammenfassung dessen, was das Projekt erreichen soll oder welche wichtigen Technologien verwendet werden. Wir bitten Copilot, uns einen schnellen Überblick zu geben.

Aktion: Bewege deinen Cursor ein paar Zeilen unterhalb des Abschnitts „Verwendung“, gib ## Übersicht ein, drücke Enter, dann gib ein paar beschreibende Wörter wie Dieses Projekt demonstriert... ein und drücke Enter. Was du siehst: Deine neue Überschrift ## Übersicht, gefolgt von deiner Aufforderung und dann ein detaillierterer Zusammenfassungsvorschlag von Copilot. Was als Nächstes passiert: Copilot füllt einen prägnanten Absatz aus, der den Zweck und die Höhepunkte deines Projekts zusammenfasst. Wenn es anders aussieht: Wenn die Zusammenfassung zu allgemein ist, kannst du deiner ursprünglichen Aufforderung spezifischere Schlüsselwörter hinzufügen (z.B. Dieses Projekt demonstriert Datenabruf und UI-Komponenten...), um Copilot zu einer maßgeschneiderteren Antwort zu führen.

💬 BeispielGib `## Übersicht` ein, drücke `Enter`, dann `Dieses Projekt demonstriert...` und `Enter`. Copilot könnte vorschlagen: „Dieses Projekt demonstriert, wie Wetterdaten in einer sauberen, responsiven Benutzeroberfläche unter Verwendung eines modernen Web-Frameworks abgerufen und angezeigt werden können.“

Du weißt, dass es funktioniert hat, wenn Copilot dir einen kurzen, beschreibenden Absatz gibt, der dein Projekt zusammenfasst und den du dann akzeptieren kannst.

6

Mit einem Lizenzhinweis abschließen

Es ist eine gute Praxis, die Lizenz für dein Projekt anzugeben. Dies teilt anderen mit, wie sie deinen Code verwenden, ändern und verteilen können. Die MIT License ist eine sehr häufige und freizügige Wahl für Open-Source-Projekte.

Aktion: Unter deinem Übersichts-Abschnitt füge eine neue Überschrift hinzu, indem du ## Lizenz eingibst, dann drücke Enter. Auf der nächsten Zeile gib Dieses Projekt ist unter der MIT License lizenziert. ein. Was du siehst: Die neue Überschrift und der Lizenzhinweis erscheinen in deiner README.md-Datei. Was als Nächstes passiert: Du hast nun die wesentlichen Abschnitte deiner README-Datei abgeschlossen. Copilot wird normalerweise keinen spezifischen Lizenztext automatisch generieren, es sei denn, du wirst stark dazu aufgefordert, daher ist es eine gute Idee, einen gängigen manuell hinzuzufügen. Wenn es anders aussieht: Wenn du eine andere Lizenz benötigst, kannst du online nach gängigen Lizenztexten suchen (z.B. „Apache 2.0 Lizenztext“) und die entsprechende Erklärung in diesen Abschnitt kopieren.

💬 BeispielGib `## Lizenz` ein, drücke `Enter`, dann `Dieses Projekt ist unter der MIT License lizenziert.`

Du weißt, dass es funktioniert hat, wenn der Abschnitt ## Lizenz in deiner README.md-Datei sichtbar und vollständig ist.

⚠️ Häufige Fehler
  • Vorschläge ungeprüft akzeptieren: Copilot ist ein KI-Assistent, kein Gedankenleser. Er könnte die falsche Programmiersprache erraten oder Befehle vorschlagen, die für dein spezifisches Projekt nicht ganz richtig sind. Überprüfe generierte Texte und Befehle immer sorgfältig und passe sie dann manuell an, um die Richtigkeit zu gewährleisten.
  • Vage oder fehlende Aufforderungen: Wenn du eine sehr kurze oder unklare Aufforderung eingibst (z.B. nur App:), könnte Copilot Schwierigkeiten haben, einen hilfreichen Vorschlag zu machen. Gib ihm immer einen kurzen, aber klaren Satz oder eine Phrase, die den Kontext für das festlegt, was es generieren soll, wie Starte die Anwendung mit:.
  • Markdown-Formatierung vergessen: Markdown verwendet spezielle Symbole wie # für Überschriften. Wenn du diese vergisst, erscheint dein Text als Klartext statt als formatierte Überschriften. Verwende die Markdown-Vorschau von VS Code (normalerweise ein Symbol oben rechts im Editorfenster, das wie zwei überlappende Seiten aussieht), um zu sehen, wie dein README aussehen wird.

❓ Schnelle Fragen

Wie lange dauert das?

Etwa 6 Minuten — die Anleitung hat 6 Schritte, und du kannst jeden beim Durcharbeiten abhaken.

Welches Tool brauche ich?

Diese Anleitung nutzt GitHub GitHub Copilot — aber die Methode funktioniert in anderen KI-Assistenten sehr ähnlich.

Muss ich etwas vorbereiten?
  • Ein kostenloses GitHub-Konto: Du musst dich unter github.com anmelden, falls du noch keins hast. Hier befindet sich der Code deines Projekts in einem speziellen Online-Ordner.
  • Ein Repository, das du bearbeiten kannst: Das ist wie ein digitaler Ordner auf GitHub, der alle Codedateien deines Projekts enthält. Stelle sicher, dass du bereits eines erstellt und geöffnet hast.
  • Visual Studio Code (VS Code): Das ist ein beliebter, kostenlos herunterladbarer Texteditor, in dem du arbeiten wirst. Du bekommst ihn unter code.visualstudio.com.
  • Die GitHub Copilot-Erweiterung für VS Code: Das ist der KI-Helfer, den wir verwenden werden. Du musst ihn innerhalb von VS Code installieren. Obwohl es normalerweise eine kostenlose Testversion gibt, beachte bitte, dass nach Ablauf der Testphase in der Regel ein kostenpflichtiger Plan erforderlich ist.
  • Geschätzte Gesamtzeit: Diese Anleitung sollte dich etwa 15-20 Minuten kosten.
Welche Fehler sollte ich vermeiden?
  • Vorschläge ungeprüft akzeptieren: Copilot ist ein KI-Assistent, kein Gedankenleser. Er könnte die falsche Programmiersprache erraten oder Befehle vorschlagen, die für dein spezifisches Projekt nicht ganz richtig sind. Überprüfe generierte Texte und Befehle immer sorgfältig und passe sie dann manuell an, um die Richtigkeit zu gewährleisten.
  • Vage oder fehlende Aufforderungen: Wenn du eine sehr kurze oder unklare Aufforderung eingibst (z.B. nur App:), könnte Copilot Schwierigkeiten haben, einen hilfreichen Vorschlag zu machen. Gib ihm immer einen kurzen, aber klaren Satz oder eine Phrase, die den Kontext für das festlegt, was es generieren soll, wie Starte die Anwendung mit:.
  • Markdown-Formatierung vergessen: Markdown verwendet spezielle Symbole wie # für Überschriften. Wenn du diese vergisst, erscheint dein Text als Klartext statt als formatierte Überschriften. Verwende die Markdown-Vorschau von VS Code (normalerweise ein Symbol oben rechts im Editorfenster, das wie zwei überlappende Seiten aussieht), um zu sehen, wie dein README aussehen wird.

Weiterlesen

War das hilfreich?

✦ Original-Schritt-für-Schritt-Anleitung vom KI-Redaktionsteam von AI World HQ Verständlich geschrieben, auf Richtigkeit geprüft.

← Zurück zu den News