자주 묻는 질문(FAQ)

현재 단계:
우수사례가 게시되었습니다. 타임라인을 참고하세요.

일반

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

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

Google Season of Docs에 참여하고 싶지만 어디서부터 시작해야 할지 모르겠습니다.

프로젝트 아이디어의 전체 목록을 확인하세요. 기술 문서 작성 커뮤니티에 문의할 수도 있습니다 (Write the Docs Slack의 #season-of-docs 채널 또는 소셜 미디어 채널에서 도움말이나 제안을 요청해 보세요).

조직은 어떤 유형의 프로젝트를 제안할 수 있나요?

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

  • 기술 작가와 오픈소스 조직에서 결정할 플랫폼에 문서 사이트를 빌드하고 사이트에 초기 기본 문서 세트를 게시합니다. 플랫폼의 예는 다음과 같습니다.

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

  • 제품 또는 기능에 대한 개념적 개요 또는 소개를 작성합니다. 팀에서 기술 문서를 하향식으로 작성하는 경우가 많습니다. 그 결과 세부정보는 많지만 제품 전체를 이해하기는 어렵습니다. 기술 문서 작성자가 이를 수정할 수 있습니다.

  • 고급 사용 사례에 관한 튜토리얼을 만듭니다.

  • 특정 작업에 관한 중점적인 방법 가이드 모음을 만듭니다.

  • 오픈소스 프로젝트의 참여자로 시작하는 방법에 관한 기본 정보와 라이선스 계약, 풀 리퀘스트 및 검토 절차, 프로젝트 빌드 등에 관한 규칙을 포함하는 참여자 가이드를 만듭니다.

동영상을 Google Season of Docs 프로젝트로 진행할 수 있나요?

예. 동영상 요구사항의 범위를 적절하게 설정하고 고화질 동영상을 제작하는 데 상당한 시간과 리소스가 소요된다는 점에 유의하세요.

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

문서 감사는 Google 문서 시즌에 적합한 프로젝트입니다. 이미 보유한 문서가 얼마나 있는지 확인합니다. 문서가 많으면 범위를 줄여야 할 수 있습니다 (예: 튜토리얼 콘텐츠만 감사). 문서가 거의 없거나 없는 경우 가장 우선순위가 높은 누락된 문서를 만드는 작업을 프로젝트에 포함하는 것이 좋습니다.

조직 및 기술 작가가 사용할 수 있는 문서 템플릿이 있나요?

Google 문서 시즌에는 문서 감사를 위한 템플릿과 체크리스트가 포함된 GitHub 저장소가 있습니다. 다른 템플릿은 생성될 때마다 추가됩니다.

The Good Docs Project는 오픈소스를 위한 최소 실행 가능한 문서 템플릿을 만들기 위해 노력하고 있습니다.

조직은 기술 작가가 작성한 문서를 사용해야 하나요?

아니요. 프로젝트가 예상대로 진행되지 않거나 요구사항이 변경되는 경우가 있습니다. Google에서는 조직이 제작한 문서나 기타 자료를 사용하도록 요구하지는 않지만 최종 평가 및 사례 연구에는 문서가 사용되지 않은 이유와 프로젝트에서 문서나 기타 자료를 사용하지 않기로 결정한 이유에 관한 논의가 포함되어야 합니다.

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

Google 문서 시즌은 전적으로 온라인에서 진행됩니다. 프로그램의 일환으로 이동할 필요는 없습니다.

Google Season of Docs에 대한 최신 소식을 확인하려면 어떻게 해야 하나요?

Google Season of Docs와 관련된 최신 업데이트 및 공지사항은 season-of-docs-announce의 공지사항 메일링 리스트를 참고하세요. 그룹에 가입하여 이메일 업데이트를 받으세요.

Google Docs 시즌 타임라인을 캘린더에 추가할 수 있나요?

http://goo.gle/2NeZVew에서 Google Season of Docs 캘린더를 구독하세요.

Google 문서 시즌에 대해 알리려면 어떻게 해야 하나요?

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

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

편하신 시간과 장소에서 만나 뵙겠습니다. 프로그램 규칙을 검토하고 샘플 콘텐츠를 사용하세요.

2019년 및 2020년 프로그램에 대한 통계를 공유해 주시겠어요?

예. 2019년 프로그램의 Google Docs 시즌 결과는 Google 오픈소스 블로그(2019, 2020)에서 확인할 수 있습니다.

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

아니요. 해외 배송 제한으로 인해 Google Season of Docs 프로젝트를 완료한 참여자에게 더 이상 티셔츠를 제공할 수 없습니다.

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

조직 관리자 가이드 및 기술 문서 작성자 가이드를 참고하세요.

모든 문서를 읽은 후에도 답변을 찾을 수 없는 경우, 토론 목록에서 Google Season of Docs 커뮤니티와 질문에 대해 논의해 보세요. 토론 채널 및 Google에 문의하는 방법에 관한 정보를 확인하세요.

Google Season of Docs의 멘토가 되려면 어떻게 해야 하나요?

Google Docs 시즌에는 공식 멘토 역할이 없습니다. 조직은 기술 문서 작성자가 온보딩되고 지원되는 방식과 문서 작성자의 문서 참여가 조직 신청의 일환으로 검토 및 승인되는 방식을 지정해야 합니다. Google 문서 시즌의 일환으로 기술 작가를 멘토링하는 데 관심이 있는 경우 조직 관리자에게 연락하여 자원봉사를 신청하세요.

Google Season of Docs는 Google Summer of Code와 같은가요?

아니요. Google Season of Docs는 기술 문서 작성 경험이 있는 사용자를 대상으로 하며 Google Summer of Code와 같은 멘토링 프로그램으로 설계되지 않았습니다.

기술 문서 작성자

기술 작가는 언제 Google Season of Docs에 신청할 수 있나요?

Google Season of Docs에는 공식 기술 작가 신청서가 없습니다. 기술 작가로서 Google Season of Docs에 참여하려면 Google Season of Docs 프로그램 페이지의 안내에 따라 오픈소스 조직에 직접 문의하세요. Google Docs 시즌 기술 작가 디렉터리에 추가하여 관심을 표현할 수도 있습니다. 자세한 내용은 기술 문서 작성자 가이드를 참고하세요.

Google 문서 시즌에 참여하려면 어떤 문서 도구와 프레임워크를 알아야 하나요?

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

하지만 대부분의 오픈소스 조직은 문서에 마크다운이나 다른 마크업 언어를 사용합니다. 선택한 조직에서 사용하는 언어를 알아보고 문법을 숙지하는 것이 좋습니다. GitHub 리드미 파일은 마크다운의 한 가지 버전을 사용하므로 마크다운으로 시작하는 것이 좋습니다. GitHub Markdown 가이드를 참고하세요.

선택한 조직에서 이미 웹사이트에 문서를 호스팅하고 있는지, 그리고 호스팅하는 경우 어떤 플랫폼을 사용하는지 확인합니다. 플랫폼은 Jekyll, Sphinx, Hugo와 같은 정적 사이트 생성기일 수 있으며, 조직에서 Read the Docs 또는 GitHub Pages에 문서를 호스팅할 수도 있습니다. 조직에서 사용하는 플랫폼을 파악한 후 관련 언어와 프레임워크를 살펴보고 실험해 보세요. 이렇게 하면 오픈소스 프로젝트를 빠르게 시작할 수 있고 선택한 오픈소스 프로젝트에 건전한 조언을 제공할 수 있습니다.

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

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

이미 오픈소스 프로젝트에 참여하고 있는 기술 작가는 Google 문서 시즌의 일환으로 계속 작업할 수 있나요?

예. 하지만 조직은 제안서에 기술 작가가 프로젝트와 이전에 맺었거나 현재 맺고 있는 관계를 명시해야 합니다.

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

기술 문서 작성자로서의 이전 경험이나 교육이 필요한가요?

기술 문서 작성 경험이나 교육은 있으면 좋지만 필수는 아닙니다. 조직에 관심 표현을 제출할 때 기술 문서 작성에 관한 경험이나 교육을 설명할 수 있습니다. 작성한 문서의 예시를 포함하여 기술 문서 또는 오픈소스 문서에 대한 관심을 보여주는 증거를 제공할 수 있어야 합니다. 오픈소스 조직은 Google Season of Docs 프로젝트를 성공적으로 완료할 수 있도록 조직에 필요한 수준의 경험을 갖춘 기술 작가를 찾습니다.

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

예. Google은 선정된 조직에 기술 작가를 고용하는 데 사용할 수 있는 지원금을 제공합니다.

좋은 기술 문서 작성자 관심분야 선언은 어떤 형식인가요?

관심 표현은 선언을 제출하기 전에 선택한 오픈소스 조직과 소통하고 아이디어를 논의하는 데 시간을 할애하는 기술 작가의 선언이 가장 좋습니다. 관심 표현 작성 가이드를 참고하세요.

Google Docs 시즌 참여에 시간이 얼마나 걸리나요?

프로젝트 규모는 다양하지만 프로그램 기간 동안 주당 5~30시간의 참여가 요구됩니다. 하지만 소요 시간은 조직과 합의한 프로젝트의 특성에 따라 다릅니다. 커밋하기 전에 프로젝트를 평가하고 오픈소스 조직과 예상 소요 시간을 논의해야 합니다.

개인으로서 오픈소스 프로젝트 문서를 작성하기 위해 조직 신청을 제출할 수 있나요? 오픈소스 프로젝트 또는 도구 사용 방법에 관한 블로그 게시물, 동영상 또는 기타 자료를 만들고 싶지만 프로젝트에 참여하거나 기여하지는 않습니다.

아니요. 오픈소스 프로젝트를 대신하여 자금을 받을 수 있는 경우에만 제안서를 제출해야 합니다. 프로젝트에 참여하고 싶다면 프로젝트에 문의하여 신청 제안서를 공동작업하세요.

학생인데 Google Docs 시즌에 참여할 수 있나요? Google Season of Docs에서 기술 문서 작성자를 위한 교육을 받을 수 있나요?

학생들은 승인된 조직과 협력할 수 있지만 Google 문서 시즌은 기술 문서 작성 기술을 가르치기 위한 것이 아닙니다. 참여하는 기술 작가는 전문적인 기술 작성 기술 또는 이에 상응하는 관련 경험을 보유하고 있어야 합니다. 참여를 원하는 학생은 신청 시 관련 글쓰기 및 편집 경험을 강조 표시해야 합니다.

Google 문서 시즌의 기술 작가와 Google 여름 코드의 학생으로 모두 참여할 수 있나요?

Google Summer of Code에 참여하는 신규 참여자 또는 학생은 Google Season of Docs 기술 작가로 지원하지 않는 것이 좋습니다.

Google Docs 시즌은 초보자를 위한 것이 아니라 이미 탄탄한 기술 문서 작성 기술과 경험을 보유한 사용자를 대상으로 합니다. Google Docs 시즌의 기술 작가는 멘토링을 받지 않으며, 대신 조직 관리자 및 기타 커뮤니티 회원의 최소한의 안내를 받아 조직의 프로젝트를 해결하기 위한 계획을 스스로 세우고 동기를 부여해야 합니다.

기술 작가로서 추가 질문이나 우려사항이 있는 경우 Google Season of Docs Google 프로그램 관리자에게 어떻게 문의하나요?

season-of-docs@google.com으로 이메일을 보내 Google Season of Docs Google 프로그램 관리자에게 문의할 수 있습니다.

기술 문서 작성 회사 또는 컨설트 회사가 Google Season of Docs에 참여할 수 있나요?

예. 조직은 제안서에 설명된 작업을 수행하도록 회사를 고용할 수 있습니다.

이력서에 Google 문서 시즌을 언급하려면 어떻게 해야 하나요?

다른 프리랜스 작업과 마찬가지로 나열합니다. 'Google Season of Docs 프로그램의 일환으로 [프로젝트 이름] 의 기술 작가로 일했습니다.'

Google Season of Docs에 참여하면 수료증을 받을 수 있나요?

Google Docs 시즌은 기술 작가에게 프로젝트 참여 증명서 또는 확인을 보낼 수 없습니다.

오픈소스 조직 관리자

오픈소스 조직의 자격요건은 무엇인가요?

조직으로 참여하려면 BRL-CAD와 같이 활발한 무료 또는 오픈소스 소프트웨어 프로젝트를 운영하는 그룹이어야 합니다. 프로젝트가 법적으로 등록된 법인일 필요는 없습니다. 조직이 Google Season of Docs 프로그램에 참여하려면 오픈소스 이니셔티브 승인 라이선스에 따라 소프트웨어를 제작 및 출시한 적이 있으며 전체 Google Season of Docs 프로그램의 조직 관리자로 활동할 참여자가 2명 이상 있어야 합니다.

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

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

조직에는 하나 이상의 오픈소스 프로젝트가 있을 수 있습니다. 재단과 같은 일부 조직에는 하나 이상의 오픈소스 프로젝트가 있는 하위 조직이 여러 개 있을 수 있습니다. 조직에 독립적인 하위 조직이 있는 경우 하위 조직별로 별도의 신청서와 제안서를 제출하세요.

한 조직에서 제안서 신청을 2개 이상 제출할 수 있나요?

아니요. 조직당 하나의 신청서만 제출하세요. 조직에 하위 조직이 있는 경우 (예: 조직이 여러 개별 오픈소스 프로젝트가 있는 재단인 경우) 각 프로젝트는 자체 신청서를 제출해야 합니다. 비록 보조금 자금이 우산 조직에서 처리하더라도 마찬가지입니다.

오픈소스 프로젝트 그룹이 단일 문서 프로젝트를 위해 함께 제안서를 제출할 수 있나요?

한 조직에서 제안서 신청서를 제출하고 다른 참여 프로젝트의 작업 및 지원을 조정할 책임이 있습니다. (예를 들어 플러그인 제작을 위한 공동 방법 가이드 작업을 원하는 대규모 프로젝트의 플러그인인 소규모 오픈소스 프로젝트 그룹은 프로젝트를 이끌 조직을 하나 선택해야 합니다.)

조직은 어떻게 수익금을 받나요?

자금을 수령하려면 조직에 Open Collective 계정이 있어야 합니다.

조직이 Google 문서 시즌에 참여하면 금전적인 보상을 받나요?

조직은 프로젝트 예산의 일부로 관리, 멘토링 또는 작업 검토를 위한 자금을 포함할 수 있습니다.

Google에서 결제 처리 수수료를 부담하나요?

결제 수단에 따라 결제 처리 수수료가 다르므로 Google에서는 결제 처리 수수료를 부담하지 않습니다. 하지만 Google에서는 Open Collective 플랫폼 수수료를 지원하며, Open Collective를 재무 호스트로 사용하기로 결정한 경우 이 수수료도 지원됩니다. 자세한 내용은 지원금 수령 가이드를 참고하세요.

조직에서 기술 작가의 비용을 예산에 반영하려면 어떻게 해야 하나요?

Write the Docs 연봉 설문조사를 참고하여 시간당 요금을 산정하는 것이 좋습니다. Write The Docs Slack에 가입하여 #season-of-docs 채널에서 관심 있는 기술 작가에게 입찰을 요청할 수도 있습니다.

조직에서 Google 문서 시즌 지원금을 사용하여 현재 참여자에게 금전적 보상을 제공할 수 있나요?

예. 단, 프로젝트 제안서는 유지보수 작업, 기존 문서의 수정 또는 업그레이드를 포함하여 새로운 작업에 관한 것이어야 합니다. 이미 완료된 작업에 사용할 수 있는 보조금은 신청할 수 없습니다.

조직에서 학생 기술 작가와 협력할 수 있나요?

학생 기술 작가가 프로젝트에 참여하도록 선택할 수 있습니다. 학생과 협력하는 경우 다음과 같은 자격을 갖춘 학생으로 참여를 제한하는 것이 좋습니다.

  • 18세 이상임
  • 기술 문서 작성 또는 기술 커뮤니케이션 프로그램 또는 과정에 등록되어 있음
  • 프로그램 또는 과정을 통해 기술 문서 작성 멘토링을 받을 수 있음을 입증할 수 있음

조직에서 두 명 이상의 기술 작가를 사용할 수 있나요?

조직에서 두 명 이상의 기술 작가를 선택하고 비용을 지불할 수 있지만, 조직에서 일하는 모든 기술 작가는 제안한 프로젝트에 참여해야 합니다. 여러 기술 작가와 협업하면 프로젝트가 더 복잡해지고 더 많은 자원봉사자와 관리 시간이 필요합니다.

조직에서 기술 문서 작성 회사를 고용하여 프로젝트를 진행할 수 있나요?

예, 조직에서 프로젝트를 진행하기 위해 기술 문서 작성 회사를 고용할 수 있습니다. 고용하는 회사가 Open Collective를 통해 수익금을 받을 수 있는지 확인합니다.

Google의 기술 문서 작성자가 프로그램이 끝나기 전에 중단했습니다. 조직에서 나머지 금액을 받을 수 있나요?

프로젝트는 프로그램이 종료되기 전에 프로젝트를 완료할 새로운 기술 작가를 찾으려고 시도하는 것이 좋습니다. 하지만 남은 금액은 프로젝트 완료가 아닌 케이스 스터디 및 최종 평가 완료 시 지급됩니다.

프로젝트를 완료할 수 없는 경우 사례 연구에서 그 이유를 조사해야 합니다. 예를 들어 문서 도구가 매우 복잡하여 기술 작가 온보딩에 장애가 되거나 프로젝트에 튜토리얼 테스트 및 업데이트가 포함되어 있고 광범위한 코딩 경험이 필요할 수 있습니다. 경험을 바탕으로 다른 프로젝트에 어떤 조언을 하시겠어요? 우수사례에 이 정보를 포함하세요.

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

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

조직은 프로젝트 제안서의 범위를 어떻게 설정해야 하나요?

프로젝트 아이디어를 개발할 때는 조직에 가치를 제공하면서도 시간이 허락하는 경우 확장할 수 있는 가장 작은 프로젝트를 찾으세요. 작을수록 좋습니다. 프로젝트 제안서를 작성할 때는 구체성이 떨어지는 대규모 프로젝트보다 더 작고 세부적인 프로젝트를 사용하는 것이 좋습니다. 프로젝트에 많은 분야별 전문성이 필요한 경우 이러한 배경 지식이 없는 사람이 작업할 수 있는 프로젝트를 포함해 보세요.

Google Season of Docs에 조직 관리자로 참여하고 Google Summer of Code에 멘토로 참여할 수 있나요?

예. Google Season of Docs와 Google Summer of Code는 별도의 프로그램입니다. 두 프로그램 모두에 참여할 수 있는 여유가 있다면 괜찮습니다.

저희 조직은 이전 Google Season of Docs 프로그램에 참여했습니다. 조직에서 다시 신청할 수 있나요?

예, 이전 Google Season of Docs 프로그램에 참여한 기관은 다시 신청할 수 있습니다.

보관처리된 데이터

Google Season of Docs 보관 파일에서 내 정보를 삭제하려면 어떻게 해야 하나요?

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