Beginnen Sie mit dem Projekt, nicht mit einem vertrauten Namen
Bei der Prüfung einer öffentlichen Release-Ankündigung stoßen Sie möglicherweise auf zwei Repositories mit ähnlichen Projektnamen. Notieren Sie die Projektwebsite, der Sie bereits vertrauen, die gefundene Organisations-URL und die zu prüfende Repository-URL. So verhindern Sie, dass ein Organisations-Badge in Ihren Notizen an ein unzusammenhängendes Suchergebnis gehängt wird.
Öffnen Sie das Organisationsprofil selbst. Ein in einem Screenshot erfasstes oder in einer README erwähntes Badge ist nicht dieselbe Beobachtung wie das aktuelle Profil. Notieren Sie das Datum Ihrer Prüfung und die genaue Domain, die neben den Profilinformationen angezeigt wird.
Lesen Sie die Domainbeziehung genau
GitHub dokumentiert sein Organisations-Badge als Ergebnis der Verifizierung des Besitzes von Domains. Die im Profil angezeigte Website- und E-Mail-Information muss mit verifizierten Domains übereinstimmen; verschiedene Domains, einschließlich bestimmter Varianten, erfordern ihre eigene Verifizierung. GitHub beschreibt die Domaingenehmigung außerdem als separates Verfahren. Quelle
Vergleichen Sie den genauen Host, statt zu entscheiden, dass jede Adresse mit dem Projektnamen gleichwertig ist. Bei einem beispielhaften Projekt sollten docs.example.org und example.org als unterschiedliche Hosts notiert werden, auch wenn die Organisation beide betreibt. Leiten Sie den Status des einen nicht aus der Schreibweise des anderen ab.
Dies ist eine Leseaufgabe. Sie müssen weder DNS ändern noch Organisationszugriff anfordern noch eine Domain selbst verifizieren, um eine öffentliche Projektquelle zu prüfen.
Halten Sie drei verschiedene Prüfungen in getrennten Zeilen
| Objekt | Nützliche Frage | Was noch zu prüfen bleibt |
|---|---|---|
| Organisationsprofil | Welche Domainbeziehung ist dokumentiert? | Ob dies die für Ihre Aufgabe relevante Organisation ist |
| Repository | Ist dies das Projekt, auf das die eigene Website der Organisation verlinkt? | Ob Sie das richtige Repository und die richtige Version geöffnet haben |
| Release oder Dokument | Was sagt die tatsächliche Passage? | Ob sie die spezifische Behauptung stützt, die Sie zitieren wollen |
Ein Profil kann Ihnen helfen, zu einem Projekt zu navigieren, ohne die Wahrheit jeder Aussage in diesem Projekt zu klären. Ebenso ist ein fehlendes Badge eine Beobachtung über das Profil, nicht der Befund, dass die Organisation betrügerisch ist.
Bewahren Sie die Belege auf, die Sie tatsächlich verwendet haben
Folgen Sie einem Projektlink von der eigenen Website der Organisation, wenn verfügbar, vergleichen Sie dessen Ziel mit dem gefundenen Repository und speichern Sie die relevante Release- oder Dokumentadresse. Wenn Website und Repository nicht übereinstimmen, behalten Sie beide Ziele und kennzeichnen Sie die Beziehung als ungeklärt, statt die poliertere Seite zu wählen.
Bei einer beispielhaften Changelog-Prüfung ist das nützliche Ergebnis ein Repository, eine Release-Version und der Satz, der das Feature stützt. Ein Badge allein ist nicht dieses Ergebnis. Verwenden Sie einen stabilen GitHub-Quellenlink, wenn sich die Datei später ändern kann.
Wenn das von Ihnen gesehene Badge neben einem Commit steht, verwenden Sie stattdessen den Commit-Signatur-Leitfaden. Er behandelt ein anderes Objekt und sollte nicht durch die Prüfung der Organisations-Domain ersetzt werden.