첫 번째 커뮤니티 튜토리얼 작성

이 스페이스는 Earth Engine 커뮤니티의 다른 사용자와 지식을 공유하려는 Earth Engine 사용자를 위해 마련되었습니다. Earth Engine 사용자가 Earth Engine 사용자를 위해 만든 이 섹션의 튜토리얼은 초보자부터 고급 사용자까지 모든 수준의 사용자를 대상으로 합니다.

튜토리얼은 마크다운 마크업 언어를 사용하여 서식이 지정된 일반 텍스트 및 코드로 제출하거나 마크다운과 실행 가능한 Python 코드가 포함된 Colab 노트북으로 제출할 수 있습니다. Earth Engine JavaScript 클라이언트 라이브러리를 사용하여 빌드된 튜토리얼은 일반적으로 Markdown으로 작성되며, Earth Engine Python 클라이언트 라이브러리를 기반으로 하는 튜토리얼에는 Colab이 권장됩니다.

시작하기 전에

윤리 강령

Earth Engine팀은 괴롭힘이 없고 포용적인 커뮤니티를 조성하기 위해 최선을 다하고 있습니다. 기여하기 전에 윤리 강령을 숙지하시기 바랍니다.

GitHub 가입

Earth Engine 커뮤니티 튜토리얼은 GitHub를 통해 공유되고 검토됩니다. GitHub 계정이 아직 없는 경우 먼저 https://github.com/join에서 계정을 만들어야 합니다.

튜토리얼 제안

새 튜토리얼에 상당한 시간과 노력을 투자하기 전에 잠재적 기여자는 몇 가지 기본 정보가 포함된 간단한 제안서를 제출해야 합니다. 이를 통해 작성자는 Earth Engine 개발자 문서의 유지관리자와 협력하여 Earth Engine 사용자 커뮤니티에 가장 유용한 튜토리얼에 집중할 수 있습니다. 또한 검토 과정에서 발생할 수 있는 왕복을 방지하여 시간을 절약할 수 있습니다.

튜토리얼 제안하기

처음 설정하기

Earth Engine 커뮤니티 GitHub 저장소에 튜토리얼을 처음 제출하는 경우 튜토리얼 작업을 시작하기 전에 다음 단계를 완료해야 합니다.

  1. 다음 위치에서 기여자 라이선스 계약 (CLA)에 동의합니다.

    https://cla.developers.google.com

  2. 커뮤니티 튜토리얼 스타일 가이드를 읽고 숙지합니다.

튜토리얼 작성 및 제출

튜토리얼 제안이 유지관리자에 의해 수락되면 튜토리얼을 수정하고 Earth Engine 커뮤니티 저장소에 제출하는 방법이 여러 가지 있습니다.

마크다운 빠른 시작

GitHub 저장소를 포크하고 GitHub 웹사이트를 통해 직접 새 튜토리얼을 만들어 추가 도구나 설정 없이 빠르게 시작할 수 있습니다.

  1. 아직 로그인하지 않았다면 GitHub에 로그인합니다.

  2. 새 튜토리얼 파일을 만들고 수정하려면 새 튜토리얼을 클릭합니다. 필요한 경우 저장소를 포크하라는 메시지가 표시됩니다.

    새 튜토리얼

  3. 양식의 튜토리얼 파일 이름을 입력합니다.

    your-tutorial-name/index.md

    여기서 your-tutorial-name은 튜토리얼의 닉네임으로, 모두 소문자입니다. 단어를 구분할 때는 대시 ('-')를 사용하세요. 폴더 이름에 공백이나 다른 구두점을 사용하지 마세요.

  4. GitHub 파일 편집기에서 튜토리얼을 직접 수정하고 '미리보기'를 사용하여 형식이 지정된 출력을 확인합니다 (GitHub 문서의 저장소에서 파일 수정도 참고).

  5. 준비가 되면 변경사항을 커밋하고 pull 요청을 엽니다.

Colab 메모장

Colab에서 튜토리얼 작성을 시작하려면 여기를 클릭하세요.

새 Colab 튜토리얼

그러면 튜토리얼을 작성하고 제출하는 방법에 관한 안내가 포함된 노트북이 열립니다.

고급

GitHub, git, 관련 도구에 이미 익숙하다면 Markdown 및 Colab 튜토리얼을 모두 제출하는 전체 프로세스는 다음과 같습니다.

  1. google/earthengine-community GitHub 저장소를 포크하고 클론합니다.

  2. tutorials 아래에 튜토리얼의 슬러그화된 닉네임 (예: tutorials/my-amazing-tutorial)으로 디렉터리를 만듭니다.

  3. 마크다운 또는 Colab에 적합한 헤더를 추가합니다.

  4. 파일 이름이 index.md(마크다운의 경우) 또는 tutorial.ipynb (Colab의 경우)인 새 디렉터리에 튜토리얼을 커밋합니다. 튜토리얼에서 사용된 이미지를 동일한 디렉터리에 커밋합니다.

  5. 새 콘텐츠를 포크에 푸시하고 pull 요청을 엽니다.

pull 요청을 만들 때 댓글 섹션에서 GitHub 문제 번호로 원래 제안을 참조해야 합니다. 예를 들어 문제가 #123인 경우 풀 요청 설명에 'Closes #123'이라는 텍스트를 넣어 원래 제안을 참조하고 튜토리얼이 게시되면 자동으로 완료로 표시합니다.

풀 요청을 열면 하나 이상의 관리자가 제출 내용을 검토하도록 할당됩니다. 검토자는 제출이 완료되고 올바르며 Earth Engine 커뮤니티 튜토리얼 스타일 가이드와 일치하는지 확인하기 위해 협력합니다.

풀 요청이 승인되면 저장소 관리자가 튜토리얼을 게시합니다.