Ć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ł Współtworzenie i wyróżnioną ikonę Edytuj.

  4. Wybierz ikonę ołówka, aby rozwidlić to repozytorium i edytować w rozwidleniu lub Edytuj ten plik w rozwidleniu 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 rozwidlenie repozytorium na następnej stronie, wybierz pozycję Rozwidlenie 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 Współtworzenie edytowany z nowym zdaniem i wyróżnionym przyciskiem Zatwierdź zmiany.

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 baza jest główną, co oznacza, że zmiany zostaną scalone z gałęzią główną.

    Uwaga

    Jeśli na tej stronie nie widzisz base repository opcji i head repository , wybierz pozycję Porównaj w rozwidleniu. 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 Otwieranie żądania ściągnięcia, na której można wyświetlić podgląd żądania ściągnięcia.

  8. Potwierdź żądanie ściągnięcia i wybierz pozycję Utwórz żądanie ściągnięcia, aby otworzyć żądanie ściągnięcia.

    Zrzut ekranu przedstawiający otwarte żądanie ściągnięcia.

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.