Wybierz fragment, który chcesz poprzeć
Załóżmy, że sprawdzasz stwierdzenie o instalacji w publicznym README własnego projektu, zanim wspomnisz o nim w artykule. Znajdź dokładny fragment i towarzyszące mu warunki. Tytuł repozytorium lub biografia profilu nie zastępują pliku zawierającego to stwierdzenie.
Ogranicz zadanie do dokumentu. Nie musisz uruchamiać projektu, sprawdzać prywatnych danych kontaktowych ani traktować konta współtwórcy jako dowodu prywatnej tożsamości.
Zastąp zmieniający się widok gałęzi linkiem do wersji
GitHub wyjaśnia, że zwykły widok pliku zazwyczaj pokazuje bieżący czubek gałęzi, więc jego zawartość może się zmieniać wraz z napływającymi commitami. Podczas przeglądania pliku naciśnięcie y zmienia adres URL na trwały link, który używa konkretnego commita zamiast nazwy gałęzi. Źródło
Skopiuj adres URL faktycznie wyświetlony po tej czynności. Otwórz go ponownie i potwierdź, że pokazuje ten sam plik i fragment. Nie wymyślaj identyfikatora commita ani nie konstruuj cytowania z podglądu wyszukiwania, którego nie otworzyłeś.
Zapisz osobną notatkę, jeśli chcesz również zachować adres bieżącej gałęzi. Link do wersji odpowiada na pytanie „jaki tekst sprawdziłem?”, a widok gałęzi pozwala sprawdzić, co projekt prezentuje obecnie.
Zapisz wystarczający kontekst dla innego czytelnika
| Pole | Zapisz z własnego przeglądu | Cel |
|---|---|---|
| Repozytorium i plik | Rzeczywisty projekt i ścieżka pliku | Zidentyfikowanie cytowanego dokumentu |
| Identyfikator commita | Wersja ze skopiowanego trwałego linku | Odróżnienie tego zrzutu od późniejszych zmian |
| Cytowany fragment | Krótki wyjątek lub wierne streszczenie | Ograniczenie twierdzenia do sprawdzonego tekstu |
| Warunki towarzyszące | Wersja, środowisko lub ograniczenia funkcji | Uniknięcie pominięcia zastrzeżenia |
| Data dostępu | Kiedy otworzyłeś źródło | Oddzielenie czasu przeglądu od historii publikacji |
Dla przykładowego README, które mówi, że funkcja eksportu jest eksperymentalna, poparte stwierdzenie zachowuje słowo „eksperymentalna”. Stały adres URL nie uzasadnia przepisania tego na sprawdzoną gwarancję. Ten przykład ilustruje praktykę cytowania; nie jest relacją o rzeczywistym repozytorium.
Zdecyduj, czy stare stwierdzenie jest nadal aktualne
Jeśli bieżąca gałąź się różni, zachowaj obie obserwacje: wcześniejszą wersję, którą cytowałeś, i obecne brzmienie, które faktycznie otworzyłeś. Nie zastępuj po cichu starszego cytowania, nadal opisując je jako ten sam przegląd.
Plik może zawierać plany, przykłady lub nieaktualne instrukcje. Przypisz te stwierdzenia projektowi, zamiast twierdzić, że samodzielnie przetestowałeś implementację. Jeśli dostęp później zawiedzie, zapisz to ograniczenie; identyfikator wersji nie jest obietnicą stałego hostingu ani uprawnień.
To jest również coś innego niż odznaka podpisanego commita. Przewodnik po odznace GitHub Verified dotyczy tego odmiennego sygnału. Aby uzyskać szerszą syntezę publicznych dokumentów, skorzystaj z listy kontrolnej przeglądu źródeł AI i zachowaj dokładną wersję, na której opiera się każde istotne twierdzenie.