Ćwiczenie — współtworzenie artykułu dokumentacji usługi Microsoft Learn

  • 4 min

Przećwiczmy przepływ pracy współtworzenia. W tym ćwiczeniu wprowadzisz niewielką zmianę w artykule dokumentacji open source w witrynie Microsoft Learn. Następnie zaproponuj zmiany, otwierając żądanie ściągnięcia.

Edytowanie artykułu

  1. Zaloguj się do konta usługi GitHub.

  2. Na karcie przeglądarki przejdź do learn.microsoft.com/contribute/content.

  3. W górnej części artykułu wybierz ikonę ołówka Edytuj .

    Zrzut ekranu przedstawiający otwarty artykuł „Contribute” i wyróżnioną ikonę Edytuj ołówkiem.

  4. Wybierz ikonę ołówka, aby sforkować to repozytorium i edytować w swoim forku lub edytować ten plik w swoim forku tego projektu.

    Zrzut ekranu przedstawiający plik źródłowy artykułu współtworzenia otwarty w przeglądarce i wyróżnioną ikonę Edytuj.

  5. Jeśli w usłudze GitHub zostanie wyświetlony monit o forkowanie repozytorium na następnej stronie, wybierz Forkuj repozytorium.

  6. Zostanie otwarte okienko Edytowanie pliku . Musisz dodać nowe zdanie na początku tego artykułu. Na początku drugiego akapitu dodaj następujące zdanie: Microsoft Learn hostuje całą dokumentację dla produktów i technologii firmy Microsoft.

    Zrzut ekranu przedstawiający plik Contribute z nowym zdaniem oraz wyróżniony przycisk zatwierdzenia zmian.

Otwieranie żądania ściągnięcia

  1. Wyświetl podgląd zmian, wybierając kartę Podgląd .

  2. Po sfinalizowaniu zmian znajdź i wybierz pozycję Zatwierdź zmiany.

  3. W polu Komunikat zatwierdzenia wpisz "WKŁAD TESTOWY".

    Zrzut ekranu przedstawiający pole komunikatu Commit (Zatwierdź komunikat) wypełnionego wkładem TEST.

  4. Wybierz pozycję Zaproponuj zmiany.

  5. Na stronie Porównywanie zmian sprawdź, czy baza ma wartość main. Oznacza to, że zmiany zostaną pobrane do gałęzi głównej w repozytorium na żywo.

    Zrzut ekranu przedstawiający stronę, aby sprawdzić, czy gałąź bazowa jest główna, co oznacza, że zmiany zostaną scalone z główną gałęzią.

    Uwaga

    Jeśli na tej stronie nie widzisz opcji base repository ani head repository, wybierz porównaj między rozwidleniami. Spowoduje to wyświetlenie opcji porównania wymaganych w tym kroku.

  6. Wybierz przycisk Utwórz żądanie ściągnięcia .

  7. Spowoduje to przejście do strony Otwórz pull request, na której można wyświetlić podgląd PR.

  8. Potwierdź swój PR i wybierz pozycję Create pull request, aby go otworzyć.

    Zrzut ekranu otwartego PR.

Uwaga

Ponieważ jest to ćwiczenie praktyczne, zmiany nie zostaną scalone z dynamiczną witryną internetową.

Gratulujemy utworzenia żądania ściągnięcia! Nie został jeszcze przesłany, ale udało Ci się ukończyć pierwszy główny krok współtworzenia. Pozostaw kartę Żądanie ściągnięcia otwarte w przeglądarce. Wróć do niego w następnym ćwiczeniu.