Zacznij od projektu, nie od znanej nazwy
Podczas sprawdzania publicznego ogłoszenia o wydaniu możesz natrafić na dwa repozytoria o podobnych nazwach projektów. Zapisz stronę projektu, której już ufasz, znaleziony adres URL organizacji oraz adres URL repozytorium, które analizujesz. Dzięki temu oznaczenie organizacji nie zostanie w Twoich notatkach przypisane do niepowiązanego wyniku wyszukiwania.
Otwórz sam profil organizacji. Oznaczenie uchwycone na zrzucie ekranu lub wspomniane w README to nie to samo, co obserwacja bieżącego profilu. Zapisz datę sprawdzenia i dokładną domenę widoczną przy informacjach w profilu.
Odczytaj relację domenową precyzyjnie
GitHub opisuje oznaczenie organizacji jako wynik weryfikacji własności domen. Wyświetlane w profilu informacje o stronie internetowej i adresie e-mail muszą być zgodne z zweryfikowanymi domenami; różne domeny, w tym niektóre warianty, wymagają własnej weryfikacji. GitHub opisuje też zatwierdzanie domeny jako osobną procedurę. Źródło
Porównuj dokładny host, zamiast uznawać, że każdy adres zawierający nazwę projektu jest równoważny. W przykładzie ilustracyjnym docs.example.org i example.org należy zapisać jako różne hosty, nawet jeśli organizacja obsługuje oba. Nie wnioskuj o statusie jednego z pisowni drugiego.
To zadanie polegające na czytaniu. Aby sprawdzić publiczne źródło projektu, nie musisz zmieniać DNS, prosić o dostęp do organizacji ani samodzielnie weryfikować domeny.
Trzymaj trzy różne kontrole w osobnych wierszach
| Obiekt | Przydatne pytanie | Co pozostaje do sprawdzenia |
|---|---|---|
| Profil organizacji | Jaka relacja domenowa jest udokumentowana? | Czy to organizacja właściwa dla Twojego zadania |
| Repozytorium | Czy to projekt podlinkowany z własnej strony organizacji? | Czy otworzyłeś właściwe repozytorium i wersję |
| Wydanie lub dokument | Co mówi faktyczny fragment? | Czy potwierdza konkretne twierdzenie, które zamierzasz zacytować |
Profil może pomóc Ci przejść do projektu, nie rozstrzygając prawdziwości każdego twierdzenia w tym projekcie. Podobnie brak oznaczenia to obserwacja dotycząca profilu, a nie ustalenie, że organizacja jest oszukańcza.
Zachowaj dowody, których faktycznie użyłeś
Gdy to możliwe, przejdź do projektu z linku na własnej stronie organizacji, porównaj jego cel z znalezionym repozytorium i zapisz adres odpowiedniego wydania lub dokumentu. Jeśli strona i repozytorium się nie zgadzają, zachowaj oba adresy i oznacz relację jako nierozstrzygniętą, zamiast wybierać staranniej wyglądającą stronę.
W przykładzie ilustracyjnym sprawdzania changelogu przydatnym wynikiem jest repozytorium, wersja wydania i zdanie potwierdzające funkcję. Samo oznaczenie nie jest takim wynikiem. Gdy plik może się później zmienić, użyj stabilnego linku do źródła na GitHubie.
Jeśli widziane oznaczenie znajduje się obok commita, skorzystaj raczej z przewodnika po podpisach commitów. Dotyczy on innego obiektu i nie powinien zastępować przeglądu domeny organizacji.