자주 묻는 질문(FAQ)

현재 단계:
2020년 Docs 시즌 프로그램이 2021년 3월 15일에 종료되었습니다. 타임라인을 참고하세요.

일반

Season of Docs는 채용 프로그램인가요?

아니요. Google에서 일하고 싶다면 Google 채용정보 웹사이트를 방문하세요.

Docs의 Season은 인턴십, 직업 또는 고용 형태로 간주되나요?

아니요. Season of Docs는 테크니컬 라이터가 독립 테크니컬 라이터로서 지원금을 받고 수행하는 활동입니다. 테크니컬 라이터는 지원금 수령을 거부할 수 있습니다.

Season of Docs에 참여해야 하는 이유는 무엇인가요?

Docs Season의 목표는 오픈소스 조직과 테크니컬 라이터 간의 협업을 촉진하는 것입니다. 이 프로그램을 통해 다음과 같은 목표를 달성할 것으로 기대됩니다.

  • 테크니컬 라이터에게 오픈소스 프로젝트에 참여하여 경험을 쌓고 오픈소스 코드에 대해 알아볼 수 있는 기회를 제공하세요.
  • 오픈소스 프로젝트에 기술 문서 작성 커뮤니티의 참여를 유도하고 오픈소스 문서를 개선할 수 있는 기회를 제공하세요.
  • 오픈소스 문서 및 기술 문서화에 대한 인식 제고

오픈소스 조직이 얻는 이점:

  • 테크니컬 라이터와 협력한 경험
  • 문서가 개선되었습니다.
  • Docs 시즌이 끝난 후에도 테크니컬 라이터와 지속적으로 공동작업할 수 있는 가능성입니다
  • 프로젝트 문서화 프로세스가 개선되었습니다.
  • 기술 문서 작성 커뮤니티에서 오픈소스 문서에 대한 인지도 향상

테크니컬 라이터가 얻는 이점:

  • 오픈소스 프로젝트에 참여한 경험
  • 개발자 중심의 문서와 코드를 사용한 작업 경험
  • 완료한 작업에 대한 기여도와 인정
  • 이력서에 추가할 사항이 있습니다.
  • Docs 시즌이 끝난 후에도 오픈소스 프로젝트와 지속적인 공동작업이 가능한지
  • 오픈소스 커뮤니티에서 테크니컬 라이터가 가져다줄 수 있는 가치에 대한 인식 제고

테크니컬 라이터가 다룰 수 있는 프로젝트 유형은 무엇인가요?

다음은 참고할 수 있는 팁입니다.

  • 테크니컬 라이터와 오픈소스 멘토가 결정할 수 있는 플랫폼에 문서 사이트를 구축하고 사이트에 초기 기본 문서 세트를 게시합니다. 플랫폼의 예는 다음과 같습니다.

  • 오픈소스 프로젝트의 기존 문서를 리팩터링하여 개선된 사용자 환경 또는 더 쉽게 액세스할 수 있는 정보 아키텍처를 제공합니다.

  • 제품이나 기능의 개념적 개요나 소개를 작성합니다. 팀은 기술 문서를 아래에서 위로 작성하는 경우가 많으며, 그 결과 세부적인 내용은 많지만 제품을 전체적으로 이해하기 어렵습니다. 테크니컬 라이터가 이 문제를 해결할 수 있습니다.

  • 주목받는 사용 사례를 위한 튜토리얼을 만드세요.

  • 특정 작업에 초점을 맞춘 안내 가이드 모음을 만듭니다.

  • 오픈소스 프로젝트의 기여자로 시작하는 방법에 관한 기본 정보는 물론 라이선스 계약, pull 요청 및 검토 프로세스, 프로젝트 빌드 등에 관한 규칙이 포함된 참여자 가이드를 만듭니다.

동영상이 Docs 시즌에 참여할 수 있는 프로젝트인가요?

예. 프로젝트 아이디어를 게시하고 기술 작성자가 제출한 프로젝트 제안서를 선택하는 것은 오픈소스 조직의 책임입니다. 동영상이 오픈소스 조직의 요구사항을 충족하면 기술 안내 동영상이라면 해당 동영상을 Docs 시즌 프로젝트로 제출할 수 있습니다. 동영상 요구사항의 범위가 제대로 지정되었는지 확인하고 고화질 동영상을 제작하려면 시간과 리소스가 필요하다는 점에 유의하세요.

멘토링 조직이 테크니컬 라이터가 제작한 문서를 사용해야 하나요?

아니요. 이 프로그램에서 제공하는 모든 문서와 코드가 행복한 경험을 하기를 바라지만 조직이 테크니컬 라이터의 문서나 코드를 사용할 필요는 없습니다.

문서 시즌은 어디에서 진행되나요?

Docs 시즌은 전적으로 온라인에서 진행됩니다. 프로그램을 통해 여행할 필요는 없습니다.

Docs 시즌에 대한 최신 정보를 확인하려면 어떻게 해야 하나요?

Docs 시즌과 관련된 최신 업데이트 및 공지는 season-of-docs-announce의 공지 메일링 리스트를 확인하세요. 그룹에 가입하면 이메일로 업데이트를 받을 수 있습니다.

Docs 시즌을 널리 알리려면 어떻게 해야 하나요?

프로그램에 대해 트윗하거나, 블로그 게시물을 작성하거나, 동영상을 게시하거나, 거주 지역에서 모임 또는 정보 세션을 주최할 수 있습니다. Google에서는 커뮤니티 (조직, 작성자 그룹, 기타 연락처)에 배포하는 데 사용할 수 있는 몇 가지 샘플 콘텐츠와 리소스를 제공합니다.

Docs 시즌 정보 세션 또는 모임을 조직하거나 주최하려면 어떻게 해야 하나요?

편한 시간과 장소에 맞춰 모임을 예약하실 수 있습니다. 프로그램 규칙을 검토하고 샘플 콘텐츠를 사용하세요.

멘토 겸 테크니컬 라이터로 Season of Docs에 참여할 수 있나요?

아니요. Google은 각 프로젝트와 테크니컬 라이터가 충분한 주의를 기울일 수 있도록 해야 하며, 이로 인해 관련된 사람들에게 나쁜 경험을 줄 수 있다고 생각합니다. 멘토 또는 테크니컬 라이터로 참여하는 것이 더 매력적인지 선택하고 적절하게 신청하시기 바랍니다.

2019년 Docs 시즌에 대해 공유할 수 있는 통계가 있나요?

예, 2019년 프로그램의 Docs 시즌 결과는 여기에서 확인할 수 있습니다.

Docs 시즌 티셔츠를 받을 수 있나요?

물론입니다. 프로젝트를 완료한 테크니컬 라이터와 멘토에게는 Docs 시즌이 제공됩니다.

티셔츠는 언제 도착하나요?

2021년 초에 티셔츠를 받으실 것으로 예상됩니다. Google은 티셔츠를 생산하고 전 세계로 배송하는 물류를 처리하기 위해 공급업체와 협력합니다. 장기 실행 프로젝트 결과가 발표된 직후 Google 프로그램 관리자가 티셔츠 스타일/사이즈를 선택하고 배송 세부정보를 입력할 수 있는 고유 액세스 코드를 이메일로 전송합니다. 티셔츠 제작 및 배송에는 일반적으로 몇 주가 걸립니다.

더 궁금한 점이 있으면 어떻게 해야 하나요?

기술 작성자 가이드, 멘토 가이드, 조직 관리자 가이드를 살펴보세요.

모든 문서를 읽은 후에도 여전히 답을 찾을 수 없다면 Slack의 문서 시즌 커뮤니티 또는 토론 목록에서 질문에 대해 논의해 보세요. 토론 채널문의 방법에 대한 정보를 참조하세요.

테크니컬 라이터용

테크니컬 라이터는 언제 Docs 시즌에 지원할 수 있나요?

테크니컬 라이터 신청 단계는 2020년 6월 9일부터 2020년 7월 9일까지 진행됩니다. 프로그램 일정기술 작성자 가이드를 참조하세요.

Season of Docs에 참여하기 위해 알아야 할 문서 도구 및 프레임워크에는 어떤 것이 있나요?

사용할 문서 도구와 프레임워크는 작업하려는 조직에 따라 다릅니다. Season of Docs의 목표 중 하나는 오픈소스 프로젝트를 통해 테크니컬 라이터들이 오픈소스 제품 문서화와 관련된 도구와 프레임워크에 대해 자세히 알아볼 수 있도록 돕는 것입니다. 따라서 일반적으로 Docs 시즌 프로젝트를 시작하기 전에 특정 문서 플랫폼에 관한 자세한 지식을 갖추고 있지 않아도 됩니다.

그러나 대부분의 오픈소스 조직은 문서에 마크다운 또는 다른 마크업 언어를 사용합니다. 선택한 조직에서 사용하는 언어를 확인하고 구문에 익숙해지는 것이 좋습니다. GitHub README 파일에서 마크다운을 사용하므로 마크다운으로 시작하는 것이 좋습니다. 마크다운에 대한 GitHub 가이드를 참고하세요.

선택한 조직이 이미 웹사이트에 문서를 호스팅하고 있는지, 있다면 어떤 플랫폼을 사용하는지 확인하세요. 플랫폼은 Jekyll, Sphinx, Hugo와 같은 정적 사이트 생성기이거나 조직에서 Docs 읽기 또는 GitHub 페이지에 문서를 호스팅할 수 있습니다. 어떤 플랫폼 조직에서 사용하는지를 파악했으면 관련 언어와 프레임워크를 살펴보고 실험해 보세요. 이를 통해 오픈소스 프로젝트를 빠르게 시작할 수 있으며 원하는 오픈소스 프로젝트에 대한 유용한 조언을 제공할 수 있습니다.

Season of Docs에 참여하려면 어떤 프로그래밍 언어를 알아야 하나요?

문서 프로젝트의 특성에 따라 프로그래밍 언어를 잘 알고 있어야 할 수도 있습니다. 문서 프로젝트를 선택하고 제안할 때는 이 점을 염두에 두고 오픈소스 조직에 필요한 지식 수준을 문의하세요.

프로젝트 제안서를 두 개 이상 제출할 수 있나요?

예. 하지만 테크니컬 라이터당 하나의 프로젝트 제안서만 수락할 수 있습니다. 애플리케이션 만들기 가이드를 참조하세요.

이미 오픈소스 프로젝트에서 작업 중인 테크니컬 라이터가 Docs의 시즌에 참여하여 계속 작업할 수 있나요?

예. 하지만 제안서에 프로젝트와의 이전 관계를 기록해야 합니다.

그룹이 하나의 프로젝트 작업을 위해 함께 제안서를 제출할 수 있나요?

아니요. 개인만 주어진 프로젝트 작업을 할 수 있습니다.

Season of Docs에 제안서를 제출하기 전에 멘토링 조직에 직접 문의할 수 있나요?

예. Docs Season of Docs를 신청하기 전에 작업하고자 하는 오픈소스 조직과 직접 커뮤니케이션할 수 있습니다. 오픈소스 멘토는 프로젝트 아이디어를 미세 조정하는 데 도움을 줄 수 있습니다.

참가 자격 요건은 무엇인가요?

  • 등록할 때 만 18세 이상이어야 합니다.
  • 프로그램 기간에 거주하게 될 국가에서 일할 자격이 있어야 합니다.
  • 현재 미국이 금수 조치하지 않는 국가에 거주해야 합니다. 프로그램 규칙 및 미국 재무부의 제재 프로그램 및 국가 정보를 참고하세요.

Google에서 신청 자격요건에 대한 예외를 적용하나요?

아니요. 재능이나 흥미 정도에 관계없이 자격요건을 충족하지 않으면 예외를 인정할 수 없습니다. 이러한 예외는 Docs의 Season of Docs 참여를 신청하는 다른 테크니컬 라이터에게 공정하지 않을 수 있습니다.

어떤 양식을 제공해야 하나요?

허용되는 참가자는 적절한 세금 양식을 제공해야 합니다.

테크니컬 라이터로서의 경력이나 교육이 필요한가요?

기술 문서 작성 경험 또는 교육이 바람직하지만 필수는 아닙니다. 프로젝트 제안서를 제출할 때 기술 문서화로 경험이나 교육을 설명할 수 있습니다. 작성한 문서의 예를 포함하여 기술 문서 또는 오픈소스 문서에 관심이 있음을 보여주는 몇 가지 증거를 제공할 수 있어야 합니다. Docs의 Season of Docs는 경험이 많거나 현재 교육을 받고 있는 테크니컬 라이터와 오픈소스 멘토를 통해 서로 배울 수 있도록 돕는 것을 목표로 합니다. 오픈소스 조직은 Docs 시즌 프로젝트를 성공적으로 완료하기 위해 조직에 필요한 경험 수준을 갖춘 테크니컬 라이터를 찾습니다.

Season of Docs에 참여하면 수익금이 지급되나요?

예. Google은 프로그램을 성공적으로 완료한 테크니컬 라이터에게 보조금을 제공합니다. 지원금을 받지 않도록 선택할 수 있습니다. 기술 작성자 지원금의 세부정보를 참조하세요.

조직에서 내 문서나 코드를 사용하지 않는 경우에도 수익금이 지급되나요?

예. 프로젝트가 오픈소스 멘토의 최종 평가를 통과하면 가능합니다. 작성된 문서나 코드를 오픈소스 프로젝트가 사용하는지 여부는 기술 작성자 지원금의 지불에 영향을 미치지 않습니다.

좋은 테크니컬 라이터 제안서란 어떤 형태일까요?

최고의 제안은 Docs 시즌 애플리케이션을 제출하기 전에 시간을 내어 선택한 오픈소스 조직과 상호작용하고 자신의 아이디어를 논의하는 테크니컬 라이터들이 제안하는 것입니다. 애플리케이션 만들기 가이드를 참조하세요.

Docs 시즌에 참여하는 데 시간이 얼마나 걸리나요?

소요 시간은 멘토 조직과 합의한 프로젝트의 특성에 따라 다릅니다. 시간 수 요구사항은 다양한 프로젝트 유형과 다양한 작업 스타일을 허용하도록 의도적으로 유연합니다. 테크니컬 라이터들은 평균적으로 일주일에 20~30시간을 투자합니다.

프로젝트 제안서를 제출하기 전에 프로젝트를 평가하고 오픈소스 조직과 예상 소요 시간을 논의해야 합니다. 다른 약정으로 인해 합의한 시간을 할애하기 어려운 경우 더 긴 기간 동안 프로젝트를 완료하면서 완료된 작업에 대한 지원금과 확인을 받을 수 있는 옵션이 있습니다. Season of Docs 애플리케이션을 제출할 때는 장기 실행 프로젝트에 대한 옵션을 지정합니다.

테크 커뮤니케이션을 전공하고 있는데 아직 업무 경험이 없습니다 그래도 참여할 수 있나요?

예. 프로젝트 제안서를 제출할 때 이전 경력에 대한 섹션에 대학교 또는 대학교 과정을 나열하세요.

미국에서 F1 비자로 승인된 학생입니다. 참여 승인을 받으려면 어떻게 해야 하나요?

자세한 내용은 소속 학교의 국제 학생 담당 부서에 문의하시기 바랍니다. Google은 어떠한 종류의 CPT 또는 OPT 승인도 제공할 수 없습니다.

수락된 모든 참가자에게 수락 확인 이메일이 전송됩니다. 맞춤 문자는 제공하지 않습니다.

Season of Docs는 내 신청서 양식의 정보를 어떻게 사용하나요?

Google 프로그램 관리자는 조직에서 프로젝트 제안을 평가할 수 있도록 애플리케이션의 일부 정보를 선택한 오픈소스 조직의 관리자에게 전달합니다.

프로젝트 참여가 승인되면 Season of Docs가 웹사이트에 프로젝트 세부정보를 게시합니다.

테크니컬 라이터 신청 양식 가이드에서 데이터 사용량에 대한 설명을 참조하세요.

Season of Docs의 테크니컬 라이터와 Google Summer of Code의 학생으로 모두 참여할 수 있나요?

현재 규정 위반은 아니지만 Google 프로그래밍 경진대회(Summer of Code)에 합격한 학생은 문서 시즌 테크니컬 라이터 자리에 지원하지 않을 것을 적극 권장합니다. 학생들은 Season of Docs에 지원하는 대신 Google 프로그래밍 경진대회(Summer of Code) 작업에 집중해야 합니다.

오픈소스 멘토 및 조직 관리자용

Season of Docs의 멘토로 참여하는 방법에 대해 자세히 알고 싶습니다. 더 자세한 정보

Docs 시즌 멘토가 되는 방법에 대한 자세한 내용은 멘토 가이드프로그램 규칙을 참조하세요.

멘토링 조직의 자격 요건은 무엇인가요?

멘토링 조직으로 참여할 수 있으려면 BRL-CAD와 같은 활성 무료/오픈소스 소프트웨어 프로젝트를 실행하는 그룹이어야 합니다. 프로젝트가 법적으로 법인일 필요는 없습니다. 프로그램에 참여하려면 멘토링 조직은 오픈소스 이니셔티브 승인 라이선스에 따라 이미 소프트웨어를 제작 및 출시했으며 Docs 프로그램 전체 시즌에서 조직 관리자 또는 멘토 역할을 할 2명 이상의 기여자가 있어야 합니다.

프로그램 규칙에 설명된 자격요건과 미국 재무부의 제재 프로그램 및 국가 정보도 참고하세요.

'조직'은 오픈소스 프로젝트와 동일한가요?

조직에는 하나 이상의 오픈소스 프로젝트가 있을 수 있습니다. 재단과 같은 일부 조직에는 각각 하나 이상의 오픈소스 프로젝트가 포함된 여러 하위 조직이 있을 수 있습니다. 조직에 독립적인 하위 조직이 있는 경우 신청서에 이를 명시하시기 바랍니다. 예를 들어 프로그래밍 언어 'Foo'는 언어 전체는 물론 해당 언어와 함께 사용되는 플러그인, 라이브러리 또는 모듈에 대한 문서에 적용될 수 있습니다.

Season of Docs에 참여하는 조직은 금전을 받나요?

양호한 상태의 조직에는 프로그램이 종료되면 승인된 테크니컬 라이터별로 지원금이 지급됩니다. 이는 테크니컬 라이터의 프로젝트가 성공했는지 여부와 무관합니다. 조직은 이 자금을 원하는 대로 사용할 수 있습니다

Google 프로그램 관리자는 기술 문서 작성 프로젝트를 위한 슬롯을 어떻게 할당하나요?

Docs 시즌의 2020년 시즌은 최대 총 50개의 테크니컬 라이팅 프로젝트로 제한됩니다.

가이드라인에 따라 조직당 최대 2개의 프로젝트가 허용되므로 수락되는 프로젝트가 너무 많지 않습니다. 하지만 무료 선택 프로세스로 모든 슬롯이 채워지지 않으면 Google 프로그램 관리자가 일부 조직에 추가 슬롯을 할당할 수 있습니다.

따라서 기술 문서 작성 프로젝트를 보낼 때 프로젝트를 3개 이상 선택할 수 있습니다. 선택한 항목을 우선순위에 따라 나열해야 하며, 가장 높은 우선순위를 목록 상단에 두어야 합니다.

테크니컬 라이터와 연락할 때는 Google 프로그램 관리자가 프로그램 웹사이트에 승인된 프로젝트 목록을 게시할 때까지 프로젝트가 승인되지 않음을 분명히 밝혀야 합니다.

제출 기한 전에 조직의 신청서를 검토할 수 있나요?

죄송하지만 조직 신청서에 관한 의견을 제공해 드릴 수 없습니다.

조직은 프로젝트 아이디어의 범위를 어떻게 지정해야 하나요?

많은 프로젝트가 진행됨에 따라 범위가 변경됩니다. 멘토는 프로젝트가 변경될 때마다 이를 인지하고 발생되는 범위를 최소화하고 필요에 따라 범위를 줄이려고 노력해야 합니다. 프로젝트 아이디어를 개발할 때는 조직에 가치를 전달할 수 있는 가장 작은 프로젝트를 찾아보세요 (시간이 되면 확장할 수 있음). 작을수록 좋습니다. 테크니컬 라이터 제안서를 평가할 때는 내용이 적고 규모가 큰 프로젝트보다는 작고 세부적인 제안서를 선택하는 것이 좋습니다. 프로젝트에 많은 도메인 전문 지식이 필요한 경우 해당 배경 지식이 없는 사람이 수행할 수 있는 프로젝트를 포함하세요.

문서 감사는 Docs 시즌에 적합한 프로젝트인가요?

문서 감사는 Docs Season을 위한 훌륭한 프로젝트입니다. 이미 얼마나 많은 문서가 있는지에 유의하세요. 문서가 많으면 범위를 줄여야 할 수도 있습니다 (예: 튜토리얼 콘텐츠 감사). 문서가 거의 또는 전혀 없는 경우, 프로젝트의 일부로 우선순위가 가장 높은 누락된 문서를 만드는 것도 포함할 수 있습니다.

조직 및 테크니컬 라이터가 사용할 수 있는 문서 템플릿이 있나요?

Good Docs 프로젝트는 오픈소스를 위해 최소한의 기능 문서 템플릿을 만들기 위해 노력하고 있습니다.

조직 관리자이자 멘토로 Season of Docs에 참여할 수 있나요?

예. 조직 관리자도 멘토가 될 수 있습니다. 별도의 멘토 양식을 작성할 필요는 없습니다 조직 신청서 양식 또는 대체 관리자 양식을 작성할 때 해당 양식의 옵션을 사용하여 본인도 멘토로서 활동하고 있음을 나타내야 합니다.

Season of Docs와 Google Summer of Code 모두에 조직 관리자나 멘토로 참가할 수 있나요?

예. Docs 시즌과 Google 프로그래밍 경진대회(Summer of Code)는 별도의 프로그램입니다. 두 프로그램에 모두 참여할 수 있는 대역폭이 있다면 괜찮습니다.

조직 관리자 또는 멘토로 Season of Docs와 Google Code-in에 모두 참여할 수 있나요?

예. Docs 시즌과 Google Code-in은 별도의 프로그램입니다. 두 프로그램에 모두 참여할 수 있는 대역폭이 있다면 괜찮습니다.

보관처리된 데이터

Docs 시즌 자료실에서 내 정보를 삭제하려면 어떻게 해야 하나요?

정보를 삭제하려면 Google에 문의하세요.