-
Notifications
You must be signed in to change notification settings - Fork 71
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #198 from RRosio/docs-working-group
Initial Documentation working group charter
- Loading branch information
Showing
2 changed files
with
55 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,50 @@ | ||
# Documentation Working Group Charter | ||
|
||
## Mission and Goals | ||
|
||
The Documentation Working Group ("Docs Working Group") serves as a support, helper, and advisory body to Jupyter Subprojects on all aspects of documentation. The core pillars of our mission: | ||
|
||
- Improve all aspects of documentation across the Jupyter ecosystem. | ||
- Make high quality documentation that is clear, comprehensive, inclusive, and serves the varying needs of Jupyter's diverse community. | ||
- Engage with the community to help users with Jupyter products, discover their needs, and connect them with relevant information, expertise and resources. | ||
|
||
The Docs Working Group will provide a place for consistent, focused, holistic efforts to be spent on documentation across the whole ecosystem. This group exists in part to provide capacity and resources to the subprojects (some of which are already suffering from a lack of resources/capacity, and more specifically to work on documentation in particular). | ||
|
||
We want all users to have positive experiences inside the Jupyter ecosystem, especially users who are learning and coming in for the first time, and users with disabilities. | ||
|
||
## Areas of Responsibility | ||
|
||
The Docs Working Group is responsible for the following: | ||
|
||
- Setting standards for documentation where needed. | ||
- The Docs working group will take ownership of documentation and related resources not owned by a Subproject. | ||
- Including the Jupyter.org documentation (under docs.jupyter.org/). | ||
|
||
## Doumentation Working Group's Activities | ||
|
||
The Docs Working Group will focus on the efforts described below, in service of its mission: | ||
|
||
- Help write documentation (inside the bounds of each Subproject's governance) including meta documentation, cross-cutting documentation (items relevant to multiple Subprojects), developer and contributor documentation, non user-facing documentation and others. | ||
- Develop recommendations and guidance for best practices surrounding documentation authoring, communication of information, concepts and styling, to promote consistency across the Jupyter ecosystem. | ||
- Community engagement to help connect users with information, expertise, and resources; and to gather feedback from the community about what needs to be documented/what information they need. | ||
- Help support and improve all aspects of documentation across the Jupyter ecosystem: our scope also includes any tasks - beyond writing documents - that will support the Doumentation Working Group's goals. To help illustrate the scope of our work, some clarifying examples are included below: | ||
- Improving the user experience inside Jupyter applications by implementing offline and interactive documentation extensions. | ||
- Implementing analytics systems for documentation webpages for better understanding of documentation usage. | ||
- Any other innovations or work that may improve Jovyans' experience in/understanding of the Jupyter ecosystem. | ||
|
||
## Founding Members | ||
|
||
- Carlos Brandt | ||
- Carol Willing | ||
- Eric Gentry | ||
- Frederic Collonval | ||
- Michał Krassowski | ||
- Nick Bollweg | ||
- Paul Ivanov | ||
- Rosio Reyes | ||
|
||
## Decision Making | ||
|
||
The Docs Working Group will establish a council (by Jupyter convention) to make decisions. | ||
|
||
The Docs Working Group Council will initially be made up of the founding members. Council members can then initiate a vote to add new members (or remove members by a two thirds majority with a quorum of two thirds of all council members). The voting process will follow the guidelines established in the [Jupyter Governance Decision Making document](https://jupyter.org/governance/decision_making.html). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters