구성원 자격

이 섹션에서는 rustdoc 팀의 구성원 자격을 다룹니다.

구성원이 되는 길

rustdoc 도구에 기여하려는 사람은 일반적으로 버그 수정이나 새 기능 구현부터 시작합니다. 안내나 도움이 필요하시면 주저하지 말고 Zulip의 t-rustdoc 채널에 질문하십시오!

Rustdoc 구성원

한동안 꾸준히 기여해 온 사람은 rustdoc 팀 구성원으로 승격될 수 있습니다(아래의 결정 방식 섹션을 참고하십시오).

이러한 승격이 적절한 시점을 판단하는 정확한 조건을 정의하기는 어렵습니다. 구성원으로 승격되는 것은 단순히 여러 항목을 충족하는지 확인하는 문제가 아닙니다. 다만 일반적으로는 다음 세 가지를 보여 주었을 때 준비가 되었다고 봅니다.

• “지속력” – 어떤 방식으로든 꾸준히 기여하고 있어야 합니다. 예를 들어 몇 개의 프로젝트를 완료했다는 의미일 수 있습니다.
• “독립성과 숙련도” – 적어도 자신의 “rustdoc 영역” 범위 안에서는 작업을 맡을 때 어느 정도 독립적으로 행동해야 합니다. 간단한 PR에 대해서는 다른 사람을 멘토링할 수 있을 만한 역량이 있어야 합니다.
• “친화성” – rustdoc 팀 구성원은 Rust 조직의 일원이 되며, 행동 강령과 관련하여 더 높은 기준을 요구받습니다. 행동 강령의 문구뿐만 아니라 그 정신도 준수해야 합니다.

구성원으로 승격되면 여러 권한이 주어집니다.

• 구성원은 r+(풀 리퀘스트 승인) 권한을 가지며 리뷰를 할 수 있습니다(앞서 설명한 대로 이 권한을 적절히 사용해야 합니다). 또한 perf/rustc-timer 및 기타 유사한 봇을 제어할 수 있는 권한도 가집니다. bors와 r+에 대한 문서는 여기를 참고하십시오.

  팁: bors 권한에 관한 몇 가지 기본 규칙은 다음과 같습니다. 먼저 악성 코드 여부를 확인하지 않았다면 try 빌드를 하지 말고, 해당 코드를 효과적으로 리뷰할 수 있다는 합리적인 확신이 없다면 r+를 하지 마십시오.

• rustdoc 팀 구성원은 Rust 조직의 구성원이므로 레이블을 수정하고 이슈에 할당될 수 있습니다.

• 구성원은 GitHub의 rust-lang/rustdoc 팀에 소속되므로, 누군가 팀 전체를 호출할 때 핑을 받습니다.

• 구성원은 rust-lang.org 웹 페이지에 등재됩니다.

또한 몇 가지 의무도 따릅니다(경우에 따라서는 선택적인 의무입니다).

• 구성원은 FCP에 최대 4주(28일) 이내에 응답해야 합니다.
• 구성원은 팀을 돕기 위해 그 밖의 다양한 메인테이너 활동에 참여할 수 있습니다.
• 구성원은 행동 강령과 관련하여 일반인보다 더 높은 기준을 요구받습니다.

rustdoc 구성원이 된다는 것의 의미

rustdoc 팀의 구성원이 되면 여러 가지 일이 일어납니다.

• 내부 논의가 이루어지는 비공개 Zulip 스트림에 접근할 수 있게 됩니다.
• 또한 all@rust-lang.org 및 rustdoc@rust-lang.org 메일링 리스트에도 구독됩니다. 메일링 리스트 구독이 어떻게 이루어지는지는 이 파일을 참고하십시오. 두 메일링 리스트 모두 발송량이 매우 적습니다(1년에 몇 통 정도입니다). all@rust-lang.org에 관하여: 이 주소는 모든 기여자에게 소식을 전하기 위한 수단입니다. 이 주소로 스팸을 보내지 않습니다.

rustdoc 팀의 역할

rustdoc에는 여러 영역이 있으며, 팀 구성원이 모든 영역에서 작업하는 것은 아닙니다. 현재 주요 영역은 다음 세 가지입니다:

• 프런트엔드: 검색, 프런트엔드 기능, 프런트엔드 설정을 포함하여 HTML/CSS/JS 및 (HTML) UI/UX 변경과 관련된 모든 것입니다.
• JSON 백엔드: rustdoc-json-types 크레이트를 포함하여 --output-format=json 백엔드에 대한 작업입니다.
• 내부 구조: rustdoc의 내부 구조로, 컴파일러와의 상호 작용, doctest, rustdoc 내부 코드 표현 생성, 명령줄 인수 파싱, 린트, intra-doc 링크 등입니다.

이 그룹들은 완전한 팀이 아니므로, 이 그룹 중 어느 곳에 속하려면 rustdoc 팀의 구성원이어야 합니다.

현재로서는 프런트엔드 그룹만 팀 저장소에서 공식적인 지위를 가지며, rustdoc-frontend라고 불립니다. 이 그룹에 참여하고 싶은 rustdoc 팀 구성원은 그룹에 추가해 달라고 요청할 수 있습니다.

rustdoc 역할은 자신의 영역에만 영향을 미치는 경우 FCP와 RFC를 자체적으로 처리하며, 그렇지 않은 경우에는 필요에 따라 다른 역할이나 다른 팀까지 절차에 참여하게 됩니다.

프런트엔드 그룹을 예로 들어 봅시다. 이 그룹은 rustdoc 팀의 일부이므로, 이 그룹에 참여하려면 rustdoc 팀의 구성원이어야 합니다. 프런트엔드 그룹에 속한다는 것은 프런트엔드 풀 리퀘스트의 리뷰 순번에 참여하도록 권장되며, 프런트엔드 FCP와 RFC에 응답해야 한다는 것을 의미합니다.

승격 결정 방식

어떤 사람이 한동안 rustdoc에 기여해 왔다면, 기존 팀 구성원이 비공개 Zulip rustdoc 팀 채널에서 그 사람을 상정할 수 있습니다. 모든 상정은 비공개 Zulip rustdoc 팀 채널에서 반드시 이루어져야 합니다.

rustdoc 팀 구성원들은 해당 인물에게 구성원 초대를 보내는 데 우려 사항이 있는지 확인하며, 10일이 지난 후(반대가 없는 경우) 초대를 보냅니다.

해당 인물이 초대를 수락하면, rustdoc 팀 리드가 새로운 역할을 반영하도록 team 저장소를 업데이트합니다.

전임 구성원 상태

rustdoc 팀 구성원이 언제든 활동을 잠시 쉬고 싶다면, 스스로 전임 구성원 상태로 전환할 수 있습니다. 전임 구성원 상태가 되면 GitHub 별칭 등에서 제외되므로 핑이나 메시지에 신경 쓰지 않아도 됩니다. 또한 r+ 권한도 갖지 않습니다. 다만 전임 구성원은 여전히 GitHub 조직 전체의 구성원으로 남습니다.

전임 구성원 상태인 사람은 언제든지 “활동” 상태로 복귀를 요청할 수 있습니다. 이 요청은 특별한 사정이 없는 한 일반적으로 자동으로 승인됩니다.

전임 구성원 상태인 사람은 이전에 도달한 수준의 팀 구성원으로 여전히 남아 있으며 이를 공개적으로 밝힐 수 있지만, 활동했던 기간도 함께 밝혀야 합니다.

6개월간 활동이 없으면 자동으로 전임 구성원 상태로 전환

구성원 또는 메인테이너가 6개월 동안 rustdoc에서 활동하지 않으면 전임 구성원 상태로 전환됩니다.