Zapoznaj się z dokumentacją dotyczącą problemów z usługą GitHub

Ukończone

Jednym z najbardziej przydatnych sposobów współtworzenia usługi Microsoft Learn jest przekazanie opinii bezpośrednio na temat artykułu dokumentacji. Korzystając z linku opinii na stronie, możesz podać zmiany, sugestie, pytania lub inne szczegółowe informacje w miarę ich przeglądania. Ponieważ większość zawartości dokumentacji usługi Microsoft Learn jest przechowywana w repozytoriach GitHub, możesz przekazać swoją opinię przy użyciu procesu GitHub o nazwie przesyłanie problemu z usługą GitHub.

Problem w usłudze GitHub to narzędzie, które umożliwia użytkownikom technologii, inżynierom i innym odwiedzającym usługę Microsoft Learn udostępnianie i śledzenie opinii na temat określonego artykułu. Wypełnij formularz, aby udokumentować swoją opinię i opublikować ją w repozytorium artykułu źródłowego w usłudze GitHub, gdzie zostanie powiadomiony autor lub właściciel. Każdy, kto odwiedza repozytorium GitHub, może zobaczyć problemy. Służą one jako przydatny sposób zbierania i przechowywania cennych opinii, takich jak zgłaszanie usterek, żądań funkcji lub notatek.

Dlaczego warto przeglądać zawartość w usłudze GitHub?

Udostępnianie recenzji zawartości w usłudze GitHub to bezpośredni sposób na współtworzenie tematu, który cię pasjonuje. Oznacza to, że możesz dodać swoje pomysły podczas eksplorowania tematu w dokumentacji firmy Microsoft. Współtworzenia szczegółowych informacji w puli wiedzy pomaga ulepszyć środowiska produktów firmy Microsoft dla milionów innych użytkowników. Twoja opinia rozwija zawartość dla innych odwiedzających platformę Microsoft Learn, którzy korzystają z produktów firmy Microsoft i ich zawartości pomocniczej.

W większości przypadków przesyłanie opinii w usłudze GitHub umożliwia wysyłanie pomysłów do zespołu odpowiedzialnego za zestaw zawartości produktu. Ta ścieżka współpracy między zespołami zawartości a użytkownikami produktów umożliwia udostępnianie opinii i ich omówienie bezpośrednio w usłudze GitHub.

Współtworowanie zawartości dokumentacji może również zapewnić Tobie profesjonalne korzyści. GitHub to dobrze znana platforma, na której można wprowadzać i śledzić wkład techniczny. Za każdym razem, gdy współtworzysz projekt w usłudze GitHub, jest on odzwierciedlany w profilu usługi GitHub. Z czasem możesz utworzyć rekord swoich wkładów, aby dodać go do swojego portfela technicznego.

Jak przekazać opinię na temat zawartości

Pamiętaj, że wiele artykułów dokumentacji w witrynie Microsoft Learn jest przechowywanych w repozytoriach GitHub. Wiele repozytoriów GitHub ma włączone problemy z usługą GitHub. Po włączeniu tej opcji możesz znaleźć opcję przesyłania opinii na tej stronie w dolnej części artykułu na learn.microsoft.com.

Aby utworzyć i przesłać problem, potrzebujesz konta usługi GitHub. Poniżej przedstawiono sposób przesyłania problemu w usłudze GitHub z artykułu Microsoft Learn:

1. Zaloguj się na istniejącym koncie GitHub.

2. Przejdź do artykułu dokumentacji platformy Microsoft Learn, w którym chcesz przekazać opinię.

3. W dolnej części artykułu znajdź nagłówek z etykietą Opinia. W tym miejscu zostanie wyświetlone pole z etykietą Ta strona.

   • Aby przekazać opinię na temat samego artykułu, wybierz pozycję Ta strona. Spowoduje to przejście do pustego formularza Problemy w usłudze GitHub, w którym można rozpocząć wypełnianie komentarzy. Teraz wybierzesz tę opcję.
   • Jeśli chcesz przejrzeć inne problemy z usługą GitHub przesłane w tym temacie, wybierz pozycję Wyświetl całą opinię na temat strony. Każdy może odczytać inne problemy z usługą GitHub w publicznym repozytorium, ale jeśli masz konto usługi GitHub, możesz również komentować problemy.
   • Wybranie pozycji Ten produkt umożliwia przekazanie opinii na temat samego produktu. Na razie nie będziemy szczegółowo omawiać tej opcji, abyśmy mogli skupić się na przekazaniu opinii na temat samej dokumentacji.

4. Po wybraniu tej strony zostanie wyświetlony monit o zalogowanie się do konta usługi GitHub, jeśli jeszcze tego nie zrobiono. Następnie w usłudze GitHub zostanie wyświetlony pusty formularz opinii o problemach.

5. Wprowadź tytuł opinii, który krótko podsumowuje swoje dane wejściowe.

6. W poniższym polu tekstowym opisz swoją opinię i podaj niezbędny kontekst. Użyj paska narzędzi, aby sformatować opis, taki jak dodawanie cudzysłowu, listy lub wzmianki.

7. Po zakończeniu wybierz pozycję Prześlij nowy problem.

Śledzenie problemów

Autor artykułu lub inni właściciele zawartości będą powiadamiani po przesłaniu problemu. Komentarze dotyczące problemu można śledzić, sprawdzając powiadomienia usługi GitHub lub wracając do repozytorium i sprawdzając kartę Problemy .

Możesz eksplorować, przeglądać i komentować inne problemy, które zostały przesłane do tego repozytorium na karcie Problemy .