연습 - Microsoft Learn 설명서 문서에 기여

  • 4분

기여 워크플로를 연습해 봅시다. 이 연습에서는 Microsoft Learn의 오픈 소스 설명서 문서를 약간 변경해 보겠습니다. 그런 다음 끌어오기 요청을 열어 변경 내용을 제안합니다.

문서 편집

  1. GitHub 계정에 로그인합니다.

  2. 브라우저 탭에서 learn.microsoft.com/contribute/content로 이동합니다.

  3. 문서 상단에서 편집 연필 아이콘을 선택합니다.

    Contribute 문서가 열려 있고 연필 편집 아이콘이 강조 표시된 스크린샷.

  4. 이 리포지토리를 포크하고 포크에서 편집하거나 이 프로젝트의 포크에서 이 파일을 편집하려면 연필 아이콘을 선택합니다.

    브라우저에 열려 있고 편집 아이콘이 강조 표시된 Contribute 문서 원본 파일의 스크린샷.

  5. GitHub가 다음 페이지에서 리포지토리를 포크하라는 메시지를 표시하면 리포지토리 포크를 선택합니다.

  6. 파일 편집 창이 열립니다. 이 문서의 시작 부분에 새로운 문장을 추가해야 합니다. 두 번째 단락 시작 부분에 다음 문장을 추가합니다. "Microsoft Learn은 Microsoft 제품 및 기술에 대한 모든 설명서를 호스트합니다."

    새 문장으로 편집된 Contribute 파일과 강조 표시된 변경 내용 커밋 단추의 스크린샷.

PR 열기

  1. 미리 보기 탭을 선택하여 변경 내용을 미리 봅니다.

  2. 변경이 완료되면 변경 커밋을 찾아 선택합니다.

  3. 메시지 커밋 필드에 "TEST 기여"를 입력합니다.

    TEST 기여로 채워진 커밋 메시지 필드의 스크린샷.

  4. 변경 제안을 선택합니다.

  5. 변경 비교 페이지에서 기본이 main(으)로 표시되는지 확인합니다. 이는 변경 내용이 라이브 리포지토리의 기본 분기로 끌어오게 됨을 의미합니다.

    Base가 Main인지 확인하기 위한 페이지의 스크린샷. 즉, 변경 내용이 기본 분기에 병합됩니다.

    참고 항목

    이 페이지에 base repository 및 head repository 옵션이 보이지 않으면 포크 간 비교를 선택합니다. 그러면 이 단계에 필요한 비교 옵션이 표시됩니다.

  6. 끌어오기 요청 만들기 단추를 선택합니다.

  7. 그러면 PR을 미리 볼 수 있는 끌어오기 요청 열기 페이지로 이동됩니다.

  8. PR을 확인하고 끌어오기 요청 만들기를 선택하여 PR을 엽니다.

    공개된 PR의 스크린샷.

참고 항목

이는 연습이므로 변경 내용이 실제 웹 사이트에 병합되지 않습니다.

축하합니다. PR을 만들었습니다! 아직 제출되지 않았지만 기여의 첫 번째 주요 단계를 완료했습니다. 브라우저에 PR 탭을 열어둡니다. 다음 연습에서 다시 다루겠습니다.