PEP 732 – Python 문서 편집 위원회
- Author:
- Joanna Jablonski
- Sponsor:
- Mariatta Wijaya
- Discussions-To:
- Discourse thread
- Status:
- Active
- Type:
- Process
- Topic:
- Governance
- Created:
- 14-Oct-2023
- Post-History:
- 20-Oct-2023
- Resolution:
- Discourse message
번역·라이선스 안내
이 비공식 한국어 번역은 원문 Copyright 절의 Public Domain or CC0-1.0, whichever is more permissive 조건에 따라 제공합니다. 원저자와 공식 원문은 그대로 표시합니다. 수정되지 않은 기준 원문 · 공식 최신판
초록
이 PEP는 다음을 다룹니다:
- Python 문서 편집 위원회를 설립합니다
- 편집 위원회의 운영 방식을 제안합니다
동기
운영 위원회(Steering Council)는 문서의 방향을 정하기 위해 2021년 3월에 문서 작업 그룹의 설립을 승인했습니다. 이 그룹은 그 이후 보다 실무적인 작업에 집중하기 위해 만들어진 문서 작업 그룹과 구별하기 위해 현재 편집 위원회라고 부릅니다.
Python 문서의 목적은 Python의 현재와 미래의 최종 사용자에게 도움을 주는 것입니다. 따라서 코어 개발 커뮤니티와 더 넓은 범위의 Python 문서 기여자들은 이를 달성하기 위해 다음과 같이 함께 노력합니다:
명세
임무
편집 위원회는 다음을 수행합니다:
- Python 문서의 품질을 유지하고 개선하기 위한 절차가 마련되도록 보장합니다
- Python 문서를 현재와 미래의 사용자에게 도움이 되는 커뮤니티 자원으로 육성합니다
- 파이썬 프로그래밍 언어를 발전시키고, 다양하고 국제적인 파이썬 프로그래머 커뮤니티의 성장을 지원하고 촉진한다는 파이썬 소프트웨어 재단의 사명에 부합하도록 행동합니다
- 문서 기여가 접근 가능하고, 포용적이며, 지속 가능하도록 보장합니다
- 문서 내용에 대한 적절한 의사 결정 절차를 수립합니다
- 결정을 내리기 전에 기여자들 사이의 합의를 이루도록 노력합니다
- 문서 내용에 관한 결정의 최종 결정권자 역할을 합니다
책임
위원회는 아래에 정한 범위 안에서 Python 문서에 관한 결정을 내릴 권한을 가집니다. 예를 들어, 위원회는 다음을 할 수 있습니다:
- Python 문서의 큰 그림 차원의 전략을 수립합니다
- 문서의 의도된 구조를 정합니다
- 글쓰기와 디자인 모두에 대한 스타일 및 편집 결정을 내립니다
- 문서 거버넌스를 담당합니다(예를 들어, 주제별 전문가에게 의사 결정 위임, 의견 불일치 해결, 결정 등.)
범위
편집 위원회는 다음 항목의 콘텐츠와 전략을 감독합니다:
| 범위 내 | 범위 외 |
|---|---|
| CPython 문서 (docs.python.org) | CPython 코드베이스의 코드 주석 |
| CPython 개발자 가이드 (devguide.python.org) | CPython 독스트링 |
| CPython 문서 번역 | PEP (peps.python.org) |
| PyPA 문서 | |
| www.python.org | |
| 파이썬 위키 (wiki.python.org) |
구성
Python 문서 편집 위원회는 다섯 명의 위원으로 구성됩니다.
편집 위원회 위원
초대 편집 위원회 위원은 다음과 같습니다:
- Mariatta Wijaya
- Ned Batchelder
- Joanna Jablonski
- Guido van Rossum
- Carol Willing
편집 위원회 위원 자격
편집 위원회 위원은 다음을 갖추어야 합니다:
- Python 프로젝트의 철학에 대한 충분한 이해
- Python 교육 및 개발자 대상 문서 작성에 대한 경험
- 건설적이고 도움이 되는 활동을 꾸준히 해 온 실적
- Python에 상당한 기여를 해 온 이력
- Python 문서 개선에 시간을 할애하려는 의지
편집 위원회 위원은 교육, 커뮤니케이션, 기술 문서 작성, Python 문서, 접근성, 번역 또는 커뮤니티 관리 분야의 경험이 있어야 합니다.
임기
편집 위원회 위원의 임기는 정해져 있지 않지만, 일반적으로 편집 위원회의 구성은 매년 바뀔 것으로 예상됩니다. 편집 위원회 위원은 위원직을 계속 유지할지 여부를 매년 확인합니다. 위원은 언제든지 사임할 수 있습니다.
위원이 연락이 끊겨 한 달 이상 연락이 닿지 않으면, 나머지 위원들은 투표를 통해 해당 위원을 교체할 수 있습니다.
편집 위원회 규모의 변경
편집 위원회는 매년 Python의 주요 릴리스가 나온 뒤에 위원회 규모를 변경해야 하는지 검토합니다. 이를 통해 문서화 커뮤니티의 요구가 시간이 지나면서 변하더라도 유연하게 대응할 수 있습니다. 위원회 규모를 늘리려면 단순 과반수의 찬성이 필요하며, 이때 정족수는 현 위원회 인원의 80%입니다.
문서 편집 위원회의 후원 조직인 운영 위원회는 새 위원 임명이나 기존 위원 해임을 포함하여 언제든지 위원회의 위원 수를 변경할 수 있습니다.
공석
어떤 이유로든 위원회에 공석이 생기면, 문서 편집 위원회는 위원 후보자 모집을 공개적으로 공고합니다. 위원 후보자는 자격 요건과 위원으로 활동하려는 동기를 기술한 간단한 문서를 제출합니다. 편집 위원회의 현직 위원들은 단순 과반수로 새 위원을 선출하며, 이때 정족수는 현 위원회 인원의 80%입니다.
개정
이 PEP는 문서 편집 위원회의 헌장 역할을 합니다. 위원회 운영 방식은 새 PEP를 작성하거나 이 PEP를 수정하여 변경할 수 있습니다. 어느 경우든 변경 사항은 커뮤니티 논의를 거친 뒤 운영 위원회가 결정합니다.
PEP 수락
PEP 732는 2023년 12월 11일에 Python 운영 위원회에서 승인되었습니다.
운영 위원회는 이 PEP에서 정한 범위에 이견은 없지만, 위원회가 충분히 자리를 잡고 우선순위가 더 높은 일들이 처리되고 나면 편집 위원회가 표준 라이브러리의 독스트링까지 포함하도록 범위를 확대하는 것을 검토하는 것이 좋을 것이라는 의견을 밝혔습니다.
연락처
편집 위원회에 결정을 요청하려면, 커뮤니티 구성원은 python/editorial-board 저장소에 이슈를 열 수 있습니다.
Copyright
This document is placed in the public domain or under the CC0-1.0-Universal license, whichever is more permissive.