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 문서 편집 위원회를 설립합니다
- 편집 위원회의 운영 방식을 제안합니다
동기
운영 위원회는 문서의 방향을 설정하기 위해 2021년 3월 Documentation Working Group의 설립을 승인했습니다. 이 그룹은 이후 보다 전술적인 업무에 집중하기 위해 만들어진 Documentation Working Group과 구별하기 위해 현재 편집 위원회라고 부릅니다.
Python 문서의 목적은 현재와 미래의 Python 최종 사용자를 지원하는 것입니다. 그러므로, 핵심 개발 커뮤니티와 더 넓은 파이썬 문서 기여자들은 이를 달성하기 위해 함께 협력합니다:
명세
권한
편집 위원회는 다음을 수행합니다:
- Python 문서의 품질을 유지하고 개선하기 위한 절차가 마련되어 있도록 보장합니다
- 현재와 미래의 사용자를 지원하는 커뮤니티 자원으로서 Python 문서를 발전시킵니다
- Python Software Foundation mission에 따라 행동하며, 이는 Python 프로그래밍 언어를 발전시키고 다양하고 국제적인 Python 프로그래머 커뮤니티의 성장을 지원하고 촉진하는 것을 목적으로 합니다
- 문서에 기여하는 일이 접근 가능하고 포용적이며 지속 가능하도록 보장합니다
- 문서 콘텐츠에 적합한 의사 결정 절차를 수립합니다
- 결정을 내리기 전에 기여자들 사이에서 합의에 도달하도록 노력합니다
- 문서 콘텐츠에 관한 결정의 최종 중재자가 됩니다
책임
위원회는 아래에 정의된 범위 내에서 Python 문서에 관한 결정을 내릴 권한을 가집니다. 예를 들어 다음을 수행할 수 있습니다:
- Python 문서에 대한 큰 틀의 전략을 수립합니다
- 문서의 의도된 구조를 설정합니다
- 작성과 디자인 모두에 관한 스타일 및 편집 결정을 내립니다
- 문서 거버넌스를 처리합니다(예를 들어, 의사 결정 권한을 주제별 전문가에게 위임하고, 의견 불일치와 결정을 해결합니다.)
범위
편집 위원회는 다음에 대한 콘텐츠와 전략을 관리·감독합니다:
| 범위 내 | 범위 외 |
|---|---|
| CPython 문서 (docs.python.org) | CPython 코드베이스의 코드 주석 |
| CPython 개발 가이드 (devguide.python.org) | CPython docstring |
| CPython 문서의 번역본 | PEP (peps.python.org) |
| PyPA 문서 | |
| www.python.org | |
| 파이썬 위키 (wiki.python.org) |
구성
Python 문서 편집 위원회는 5명의 위원으로 구성됩니다.
편집 위원회 위원
최초 편집 위원회 위원은 다음과 같습니다:
- 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는 accepted by the Python Steering Council on December 11, 2023되었습니다.
운영 위원회는 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.