Begin bij het project, niet bij een bekende naam
Je kunt twee repositories met vergelijkbare projectnamen tegenkomen terwijl je een openbare release-aankondiging controleert. Noteer de projectwebsite die je al vertrouwt, de organisatie-URL die je hebt gevonden en de repository-URL die je beoordeelt. Zo voorkom je dat een organisatiebadge in je notities aan een ongerelateerd zoekresultaat wordt gekoppeld.
Open het organisatieprofiel zelf. Een badge die in een screenshot is vastgelegd of in een README wordt genoemd, is niet dezelfde waarneming als het huidige profiel. Noteer de datum waarop je het hebt gecontroleerd en het exacte domein dat bij de profielinformatie wordt getoond.
Lees de domeinrelatie precies
GitHub documenteert zijn organisatiebadge als het resultaat van het verifiëren van eigendom van domeinen. De website- en e-mailinformatie die op het profiel wordt getoond, moet overeenkomen met geverifieerde domeinen; verschillende domeinen, inclusief bepaalde varianten, vereisen hun eigen verificatie. GitHub beschrijft domeingoedkeuring ook als een aparte procedure. Bron
Vergelijk de exacte host in plaats van te besluiten dat elk adres met de projectnaam erin gelijkwaardig is. Voor een illustratief project moeten docs.example.org en example.org als verschillende hosts worden genoteerd, zelfs als de organisatie beide beheert. Leid de status van de een niet af uit de spelling van de ander.
Dit is een leestaak. Je hoeft geen DNS te wijzigen, geen organisatietoegang aan te vragen en geen domein zelf te verifiëren om een openbare projectbron te inspecteren.
Houd drie verschillende controles in aparte rijen
| Object | Nuttige vraag | Wat nog moet worden gecontroleerd |
|---|---|---|
| Organisatieprofiel | Welke domeinrelatie is gedocumenteerd? | Of dit de organisatie is die relevant is voor je taak |
| Repository | Is dit het project dat door de eigen site van de organisatie wordt gelinkt? | Of je de juiste repository en versie hebt geopend |
| Release of document | Wat staat er in de daadwerkelijke passage? | Of die de specifieke bewering ondersteunt die je wilt citeren |
Een profiel kan je helpen naar een project te navigeren zonder de waarheid van elke bewering in dat project vast te stellen. Evenzo is een ontbrekende badge een waarneming over het profiel, niet de vaststelling dat de organisatie frauduleus is.
Bewaar het bewijs dat je daadwerkelijk hebt gebruikt
Volg een projectlink van de eigen website van de organisatie wanneer die beschikbaar is, vergelijk de bestemming met de repository die je hebt gevonden en sla het relevante release- of documentadres op. Als de site en de repository van elkaar afwijken, bewaar dan beide bestemmingen en markeer de relatie als onopgelost in plaats van de meest gepolijste pagina te kiezen.
Voor een illustratieve changelog-controle is het nuttige resultaat een repository, een releaseversie en de zin die de functie ondersteunt. Een badge alleen is dat resultaat niet. Gebruik een stabiele GitHub-bronlink wanneer het bestand later kan veranderen.
Als de badge die je zag naast een commit staat, gebruik dan de commit-handtekeninggids in plaats daarvan. Die gaat over een ander object en mag niet worden vervangen door de beoordeling van het organisatiedomein.