자주 묻는 질문(FAQ)

현재 단계:
결과 발표 일정

일반

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

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

현재 프로그램은 Docs 시즌 2019 및 2020과 어떻게 다른가요?

현재 Season of Docs 프로그램은 지난 몇 년과 비교하여 다음과 같은 중요한 변화가 있습니다.

  • 테크니컬 라이터는 더 이상 Google을 통해 조직과의 일치를 신청하지 않음
  • 조직은 지원서의 일부로 예산 및 제안된 측정항목을 포함한 프로젝트 제안서를 제출합니다.
  • 승인된 조직은 보조금을 받아 테크니컬 라이터에게 자금을 지원하는 데 사용합니다.
  • 조직에서 최종 평가 및 우수사례 제출

Season of Docs가 이렇게 변경한 이유는 무엇인가요?

Google의 목표는 전 세계의 정보를 체계화하여 모두가 편리하게 이용할 수 있도록 하는 것입니다. Google은 오픈소스에서 효과적인 문서화 관행을 배우는 데 중점을 두기 위해 Docs 시즌에 다시 초점을 맞추함으로써 장기적으로 더 큰 영향력을 발휘할 수 있기를 바랍니다.

우리 조직에서 Docs 시즌에 참여하고 싶지만 어디서부터 시작해야 할지 모르겠습니다.

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

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

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

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

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

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

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

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

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

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

예. 동영상 요구사항의 범위가 제대로 지정되었는지 확인하고 고화질 동영상을 제작하려면 상당한 시간과 리소스가 필요하다는 점에 유의하세요.

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

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

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

Season of Docs에는 문서 감사를 수행하기 위한 템플릿과 체크리스트가 포함된 GitHub 저장소가 있습니다. 다른 템플릿이 만들어지면 추가할 예정입니다.

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

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

아니요. 경우에 따라 프로젝트가 예상대로 작동하지 않거나 요구사항이 변경될 수 있습니다. Google은 조직에서 생성된 문서나 기타 자료를 사용하도록 요구하지는 않지만 최종 평가 및 우수사례에는 문서가 사용되지 않은 이유와 프로젝트에서 문서 또는 기타 자료를 사용하지 않기로 결정한 방법에 대한 논의가 포함될 것으로 예상됩니다.

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

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

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

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

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

예. 이 링크를 통해 추가할 수 있습니다.

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

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

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

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

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

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

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

아니요. 국제 배송 제약으로 인해 Docs 시즌 프로젝트를 완료한 참가자에게는 더 이상 티셔츠를 제공할 수 없습니다.

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

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

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

Docs 시즌의 멘토가 되려면 어떻게 해야 하나요?

Docs 시즌에는 공식 멘토 역할이 없습니다. 조직은 테크니컬 라이터의 온보딩 및 지원 방식과 조직 신청서의 일환으로 문서 기여를 검토하고 승인하는 방법을 지정해야 합니다. Docs 시즌의 일환으로 테크니컬 라이터를 멘토링하는 데 관심이 있다면 조직 관리자와 협력하여 자원봉사를 하는 것이 좋습니다.

Google 프로그래밍 경진대회(Summer of Code)와 같이 Docs의 계절이 다가올까요?

아니요. Docs의 Season은 어느 정도 기술적인 글쓰기 경험이 있는 사람을 대상으로 하며, Google 프로그래밍 경진대회(Summer of Code)와 같은 멘토링 프로그램으로 설계되지 않았습니다.

테크니컬 라이터용

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

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

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

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

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

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

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

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

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

예. 하지만 조직은 테크니컬 라이터와 프로젝트의 이전 또는 지속적인 관계를 제안서에 기록해야 합니다.

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

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

기술 문서 작성 경험 또는 교육이 바람직하지만 필수는 아닙니다. 조직에 관심 서약서를 제출할 때는 기술 문서화에 대한 경험이나 교육을 설명할 수 있습니다. 작성한 문서의 예를 포함하여 기술 문서 또는 오픈소스 문서에 관심이 있음을 보여주는 몇 가지 증거를 제공할 수 있습니다. 오픈소스 조직은 Docs 시즌을 성공적으로 완료하기 위해 조직에 필요한 경험 수준을 갖춘 테크니컬 라이터를 찾습니다.

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

예. Google은 승인된 조직에 기술 작성자를 고용하는 데 사용할 수 있도록 지원금을 제공합니다.

좋은 테크니컬 라이터의 관심 표현은 어떤 형태일까요?

가장 좋은 관점은 진술서를 제출하기 전에 시간을 내어 선택한 오픈소스 조직과 자신의 아이디어를 논의하고 의견을 제시하는 테크니컬 라이터들의 의견입니다. 신청서 작성 가이드를 참고하세요.

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

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

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

아니요. 오픈소스 프로젝트를 대신하여 자금을 받을 수 있는 경우에만 제안서를 제출해야 합니다. 프로젝트에 연락하여 신청 제안서에 관해 공동작업을 하는 것이 좋습니다.

학생인 경우에도 Docs 시즌에 참여할 수 있나요? Season of Docs는 테크니컬 라이터가 되는 방법을 배우나요?

학생들은 승인된 조직에서 작업할 수 있지만, Docs Season은 기술적인 글쓰기 스킬을 가르치기 위한 것이 아닙니다. Google은 프로그램에 참여하는 기술 작가에게 전문적인 기술 글쓰기 기술 또는 이에 상응하는 관련 경험을 보유할 것으로 기대합니다. 참여를 원하는 학생들은 관심 있는 조직 및 프로젝트에 연락할 때 본인의 작문 및 편집 경험 관련 내용을 강조해야 합니다.

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

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

또한 Docs Season은 초보자를 대상으로 하지 않습니다. 이미 훌륭한 기술적 글쓰기 능력과 경험이 있는 사람들을 대상으로 합니다. Season of Docs의 테크니컬 라이터는 멘토링을 받지 않으며, 대신 조직 관리자 및 다른 커뮤니티 구성원으로부터 최소한의 지도만으로 조직 프로젝트 처리 계획을 수립하기 위해 자기 주도적인 태도를 가지고 동기를 부여받아야 합니다.

테크니컬 라이터가 추가 질문이나 우려사항이 있는 경우 Docs Season Google 프로그램 관리자에게 연락하려면 어떻게 해야 하나요?

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

기술 문서 작성 회사나 컨설팅 업체도 Season of Docs에 참여할 수 있나요?

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

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

다른 프리랜서 작업에서와 마찬가지로 나열하세요(예: 'Docs 시즌 프로그램의 일환으로 [프로젝트 이름] 의 테크니컬 라이터로 근무함').

Season of Docs에 참여하기 위한 수료 인증서를 제공하나요?

테크니컬 라이터에게는 프로젝트 참여 증명서나 확인서를 보내드릴 수 없습니다.

오픈소스 조직 관리자용

오픈소스 조직이 되기 위한 자격 요건은 무엇인가요?

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

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

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

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

조직에서 두 개 이상의 제안서 신청서를 제출할 수 있나요?

아니요. 신청서는 조직당 하나만 제출해 주세요. 하위 조직이 있는 경우 (예: 조직이 여러 개별 오픈소스 프로젝트가 있는 기반인 경우) 보조금을 상위 조직에서 처리하더라도 각 프로젝트는 자체 신청서를 제출해야 합니다.

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

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

단체는 어떤 방식으로 기부금을 수령하나요?

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

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

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

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

결제 수단에 따라 다를 수 있으므로 결제 처리 수수료는 Google에서 부담하지 않습니다. 하지만 Open Collective 플랫폼 수수료는 Google이 부담하며 Open Collective를 회계 호스트로 사용하기로 한 경우 수수료도 부담합니다. 자세한 내용은 Grants 수신 가이드를 참조하세요.

조직에서 테크니컬 라이터의 비용 예산을 어떻게 책정해야 하나요?

Docs 급여 설문조사 작성을 살펴보고 시간당 급여를 확인하는 것이 좋습니다. Write The Docs Slack에 가입하여 관심 있는 테크니컬 라이터를 대상으로 #season-of-docs 채널에서 입찰해 달라고 요청할 수 있습니다.

조직에서 Docs 시즌 지원금을 사용하여 현재 기여자에게 비용을 지불할 수 있나요?

예. 하지만 프로젝트 제안서는 새로운 작업 (유지보수 작업, 수정 또는 기존 문서 업그레이드 포함)을 위한 것이어야 합니다. 이미 완료된 작업의 비용은 지원금을 신청하지 않아도 됩니다.

우리 조직에서 학생 테크니컬 라이터와 함께 작업할 수 있나요?

학생 테크니컬 라이터가 프로젝트에 참여하도록 할 수도 있습니다. 학생과 함께 작업하려는 경우 다음과 같은 학생만 참여할 수 있도록 제한하는 것이 좋습니다.

  • 만 18세 이상
  • 테크니컬 라이팅 또는 기술 커뮤니케이션 프로그램이나 과정에 등록함
  • 프로그램이나 과정을 통해 기술 글쓰기 멘토링에 대한 입증 가능한 액세스 권한을 갖습니다.

2명 이상의 테크니컬 라이터와 함께 작업할 수 있나요?

조직에서는 2명 이상의 기술 작성자를 선정하여 지불할 수 있지만 조직에서 함께 작업하는 모든 기술 작성자는 제안한 프로젝트를 작업해야 합니다. 여러 명의 테크니컬 라이터와 협업하면 프로젝트가 복잡해지고 자원봉사자와 관리 시간이 더 많이 소요될 수 있습니다.

우리 조직에서 프로젝트 작업을 맡길 기술 집필 회사를 고용할 수 있나요?

예. 귀하의 조직은 프로젝트 작업을 맡길 기술 집필 회사를 고용할 수 있습니다. 채용하는 회사가 Open Collective를 통해 지급을 받을 수 있어야 합니다.

테크니컬 라이터가 프로그램이 끝나기 전에 퇴사했습니다. 차액을 지급받을 수 있나요?

따라서 프로그램이 끝나기 전에 프로젝트를 완료할 새로운 테크니컬 라이터를 찾아보는 것이 좋습니다. 단, 잔액의 지급은 프로젝트 완료가 아닌 우수사례 및 최종 평가 완료를 기준으로 합니다.

프로젝트를 완료할 수 없는 경우 우수사례를 통해 이유를 조사해야 합니다. 예를 들어 문서 도구가 매우 복잡하고 테크니컬 라이터 온보딩을 방해하는 것으로 나타났거나, 프로젝트에 튜토리얼 테스트 및 업데이트가 포함되고 광범위한 코딩 경험이 필요했을 수 있습니다. 경험을 바탕으로 다른 프로젝트에 무엇을 추천하시겠어요? 사례 연구에 해당 정보를 포함합니다.

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

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

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

프로젝트 아이디어를 개발할 때는 조직에 가치를 제공하는 가장 작은 프로젝트를 찾아보세요 (시간이 되면 확장할 수 있음). 작을수록 좋습니다. 프로젝트 제안서를 작성할 때는 지정되지 않은 대규모 프로젝트보다 작고 세부적인 프로젝트를 고수하는 것이 좋습니다. 프로젝트에 많은 도메인 전문 지식이 필요한 경우 해당 배경 지식이 없는 사람이 작업할 수 있는 프로젝트를 포함하는 것이 좋습니다.

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

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

우리 조직은 이전 Docs 시즌 프로그램에 참여했습니다. 다시 신청할 수 있나요?

예. 이전 Docs 시즌 프로그램에 참여한 조직은 다시 신청할 수 있습니다.

보관처리된 데이터

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

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