GitHub-README ohne Lizenz: Was das für Ihr Repository bedeutet

VeröffentlichtToolGitHub-README-Generator

Inhalt
  1. Sichtbarer Code ist nicht frei nutzbar
  2. Wie wirkt ein Repository ohne README?
  3. Diese Bestandteile gehören in eine gute README: und warum
  4. So füllen Sie diese Abschnitte selbst aus
  5. Warum die Wahl der Lizenz unterschiedlich ausfällt
  6. Fazit
  7. Häufig gestellte Fragen

Wer Code in einem öffentlichen Repository ablegt, den jeder einsehen kann, geht oft davon aus, dass man ihn selbstverständlich auch verwenden darf. Die offizielle Dokumentation von GitHub sagt jedoch etwas anderes: Ein Repository ohne Lizenzdatei liegt rechtlich vollständig in den Händen der Urheberin oder des Urhebers, auch wenn der Quellcode sichtbar ist. Andere haben keine Erlaubnis, den Code zu kopieren, zu ändern, zu verbreiten oder weiterzuverwenden.

Zusammenfassung ① Keine Lizenzdatei bedeutet nicht „keine Regeln“, sondern es gilt der strengste Standard („alle Rechte vorbehalten“) ② Die README ist das Einzige, anhand dessen ein Besucher in wenigen Sekunden entscheidet, ob er dieses Repository nutzt ③ Projektbeschreibung, Installation, Anwendungsbeispiel, Lizenz und Hinweise zur Mitarbeit sollten vollständig enthalten sein, damit Besucher nicht abspringen

Sichtbarer Code ist nicht frei nutzbar

Wenn Sie ein Repository auf GitHub hochladen, kann jeder den Code einsehen. Deshalb liegt der Irrtum nahe, öffentlich zugänglicher Code dürfe frei verwendet werden. Einsehbarkeit und Erlaubnis zur Weiterverwendung sind jedoch zwei grundverschiedene Dinge.

Laut der offiziellen GitHub-Dokumentation gilt für ein Repository ohne ausdrückliche Lizenzdatei standardmäßig: Die Urheberin oder der Urheber behält die ausschließlichen Rechte an diesem Code. Außer dem Autor hat also niemand die ausdrückliche Erlaubnis, den Code zu kopieren, zu ändern oder zu verbreiten – und auch nicht, ihn im eigenen Projekt einzusetzen.

Dabei wird häufig etwas übersehen: Eine fehlende Lizenz heißt nicht, dass keinerlei Regeln gelten. Es ist genau umgekehrt. Ohne Lizenz greift der nach dem Urheberrecht strengste Standard, nämlich „alle Rechte liegen bei der Urheberin bzw. dem Urheber“. Allein weil eine Datei fehlt, wird das Repository faktisch zu Code, den man zwar ansehen, aber nicht verwenden darf.

Wie wirkt ein Repository ohne README?

Unabhängig von der Lizenzfrage fehlt Besuchern bei einem Repository ohne oder mit nur dürftiger README jede Entscheidungsgrundlage. Stellen Sie sich ein Repository vor, in dem nur eine Liste von Code-Dateien steht.

Besucher müssen selbst herausfinden, was das Projekt macht, ob es bei ihrem Problem hilft, wie man es installiert und ob sie den Code überhaupt nutzen dürfen. Die meisten klicken an dieser Stelle einfach auf „Zurück“.

Es gibt noch ein häufigeres Fehlerbild: Die README-Datei existiert, enthält aber nur den hineinkopierten vollständigen Lizenztext. Die rechtlichen Bedingungen sind zwar genannt, aber was das Projekt eigentlich macht, steht nirgends. Besucher wissen dann nur, ob sie den Code nutzen dürfen – warum sie ihn brauchen könnten, bleibt unklar.

Diese Bestandteile gehören in eine gute README: und warum

Wenn Sie sich in einen Besucher hineinversetzen, der zum ersten Mal in Ihrem Repository landet, ergibt sich die Reihenfolge fast von selbst.

  • Projektbeschreibung (ganz oben): Schon auf dem ersten Bildschirm muss klar sein, was das Projekt macht und wozu es nötig ist. Besucher entscheiden innerhalb weniger Sekunden, ob sie weiterlesen.
  • Installation: Es braucht einen Installationsbefehl, den man direkt ins Terminal einfügen kann. Erklärungen im Stil von „Installieren Sie es irgendwie selbst“ führen dazu, dass Besucher abspringen.
  • Anwendungsbeispiel: Ein kurzes, tatsächlich lauffähiges Codebeispiel verschafft schneller Verständnis als lange Erklärungen. Besucher wollen ein Beispiel lieber kopieren und sofort ausprobieren, als Text zu lesen.
  • Lizenz: Aus dem oben erläuterten Grund ist sie die einzige Möglichkeit, ausdrücklich festzuhalten, ob der Code verwendet werden darf.
  • Mitarbeit: Wenn Sie externe Beiträge wünschen, sollten Sie zumindest kurz erklären, wie Issues erstellt werden oder welche Regeln für Pull Requests gelten.

So füllen Sie diese Abschnitte selbst aus

Wenn Sie eine README von Grund auf schreiben, müssen Sie die fünf genannten Abschnitte der Reihe nach anordnen und für jeden die passende Markdown-Syntax (Überschriftenebenen, Codeblöcke, Listen) von Hand setzen. Nach der Projektbeschreibung packen Sie den Installationsbefehl in einen Codeblock, trennen das Anwendungsbeispiel in einen eigenen Block ab, und wenn Sie Badges einbinden möchten, müssen Sie die Syntax für shields.io-Bildlinks erst nachschlagen und einfügen.

Wollen Sie zusätzlich ein Inhaltsverzeichnis, müssen Sie die Anker-Links jeder Überschrift einzeln anpassen, und beim Lizenzabschnitt hängt der Wortlaut von der gewählten Lizenz ab. Jeder einzelne Punkt ist nicht schwer, aber alles zusammenzutragen und einheitlich zu formatieren dauert länger, als man denkt.

GitHub-README-Generator

Der GitHub-README-Generator erstellt aus Ihren Angaben eine fertige README.md, inklusive Badges, Inhaltsverzeichnis und Abschnitt zum Mitwirken.

Um diese Routinearbeit zu verkürzen, ist ein Tool praktisch, bei dem Sie nur die Inhalte je Abschnitt eingeben und die Formatierung automatisch erfolgt. Sie tragen Projektnamen, Kurzbeschreibung, ausführliche Beschreibung, Funktionsliste, Tech-Stack, Installationsbefehl, Beispielcode für die Anwendung, Lizenztyp, Autor und Repository-Adresse ein – und je nachdem, ob Badges, Inhaltsverzeichnis und Abschnitt zur Mitarbeit enthalten sein sollen, wird sofort eine fertige README.md erzeugt.

Warum die Wahl der Lizenz unterschiedlich ausfällt

Wenn „keine Lizenz“ gleichbedeutend mit „alle Rechte vorbehalten“ ist, dann wird die Weiterverwendung ab dem Moment, in dem Sie eine Lizenz hinzufügen, nach den Bedingungen dieser Lizenz erlaubt. Je nach gewählter Lizenz unterscheiden sich die Bedingungen für die Weiterverwendung erheblich, daher ist es wichtig, sie passend zum Charakter des Projekts auszuwählen.

LizenzMerkmale
MITDie Bedingungen sind am einfachsten; kommerzielle Nutzung, Änderung und Verbreitung sind weitgehend erlaubt
Apache-2.0Ähnlich wie MIT, enthält aber ausdrücklich Patentklauseln
GPL-3.0Abgeleitete Werke, die diesen Code verwenden, müssen ebenfalls unter derselben Lizenz veröffentlicht werden
BSD-3-ClauseÄhnlich wie MIT, enthält aber eine Klausel, die Werbung unter dem Namen des Autors einschränkt

Man kann nicht pauschal sagen, welche Lizenz „die beste“ ist. Die Wahl hängt davon ab, wie frei Sie das Projekt freigeben möchten und ob Sie auch für abgeleitete Werke dieselben Bedingungen vorschreiben wollen. Das liegt im Ermessen der Urheberin bzw. des Urhebers; eine allgemeingültige richtige Antwort gibt es nicht.

Fazit

  • Bei einem öffentlichen Repository ohne Lizenzdatei ist die Weiterverwendung nicht erlaubt, auch wenn der Code sichtbar ist; das ist das Grundprinzip, das GitHub offiziell erläutert
  • „Keine Lizenz“ bedeutet nicht „keine Regeln“, sondern den strengsten Standard („alle Rechte vorbehalten“)
  • Eine README sollte in der Reihenfolge Projektbeschreibung, Installation, Anwendungsbeispiel, Lizenz und Mitarbeit aufgebaut sein, damit sie dem Entscheidungsweg der Besucher entspricht
  • Repositorys mit Code, aber ohne README, oder mit vollständigem Lizenztext, aber ohne Beschreibung, führen dazu, dass Besucher abspringen
  • Bei den Lizenztypen geht es nicht um besser oder schlechter, sondern darum, wie weit Sie die Bedingungen für die Weiterverwendung öffnen möchten
GitHub-README-Generator

Der GitHub-README-Generator erstellt aus Ihren Angaben eine fertige README.md, inklusive Badges, Inhaltsverzeichnis und Abschnitt zum Mitwirken.

Häufig gestellte Fragen

Ist mein Code automatisch urheberrechtlich geschützt, wenn ich ihn auf GitHub hochlade?

Ja, das Urheberrecht entsteht ab dem Zeitpunkt, an dem Sie den Code schreiben. Entscheidend ist jedoch: Ohne Lizenzdatei haben Sie anderen die Weiterverwendung nicht erlaubt. Urheberrechtsschutz und Erlaubnis zur Weiterverwendung sind zwei verschiedene Dinge.

Darf ich Code aus einem fremden Repository ohne Lizenzdatei in einem privaten Projekt verwenden?

Grundsätzlich ist es sicherer, den Code nicht ohne ausdrückliche Erlaubnis des Urhebers zu verwenden. Fehlt eine Lizenzdatei, sind keine Bedingungen für die Weiterverwendung festgelegt. Wenn Sie den Code trotzdem nutzen möchten, fragen Sie am besten direkt bei den Verantwortlichen des Repositorys nach oder suchen Sie nach alternativem Code mit ausdrücklich angegebener Lizenz.

Muss ich in der README ein Inhaltsverzeichnis einfügen?

Nötig ist es nicht, aber es wird nützlicher, je länger die README wird. Besucher können direkt zu dem gewünschten Abschnitt (Installation, Anwendung, Lizenz usw.) springen und müssen nicht bis zum Ende scrollen. Bei einem kleinen Projekt können Sie darauf verzichten.

Darf ich die Lizenz später ändern?

Wer das Repository weiterhin als Urheber betreut, kann den Lizenztext grundsätzlich ändern. Die Änderung gilt jedoch nicht rückwirkend für Personen, die den Code bereits unter den früheren Lizenzbedingungen übernommen haben. Halten Sie deshalb Zeitpunkt und Grund der Änderung in der README oder in der Commit-Historie klar fest.

Dieser Artikel basiert auf unserem koreanischen Original. Koreanisches Original lesen

Ähnliche Artikel

  1. Datenschutzerklärung: Warum schon ein Cookie sie erfordertWarum schon Cookies oder Werbe-IDs eine Datenschutzerklärung nötig machen und warum Standardvorlagen bei AdSense-Prüfungen oft nicht ausreichen.
  2. WLAN-QR-Code Format: Aufbau und Funktionsweise erklärtWarum sich das Smartphone nach dem Scannen sofort mit dem WLAN verbindet: Felder des QR-Strings, Sonderzeichen maskieren und versteckte Netzwerke mit H:true.
  3. Wortwolke: Warum das größte Wort nicht das häufigste istWarum das größte Wort in einer Wortwolke nicht der Spitzenreiter sein muss: Stoppwörter, Größenskalierung und Platzierung erklärt, plus Häufigkeit selbst prüfen.
  4. Brainstorming-Wortkombinationen: Permutation und GeburtstagsparadoxonSo berechnen Sie mit der Permutationsformel die Zahl möglicher Wortkombinationen, verstehen das Geburtstagsparadoxon und finden Namen in 5 Schritten.
  5. Visitenkarten-Format: Größen im Ländervergleich (DE, US, JP)Warum Visitenkarten in Korea 90×50 mm, in den USA 89×51 mm und in Japan 91×55 mm messen, wie ISO 7810 damit zusammenhängt und wie Sie ein Bild erstellen.
  6. Cron-Ausdruck lesen: 5 Felder und die Tag/Wochentag-FalleCron-Ausdrücke bestehen aus fünf Feldern in fester Reihenfolge. So lesen Sie die Symbole und vermeiden die ODER-Falle bei Tag und Wochentag.

Passende Tools