-
Notifications
You must be signed in to change notification settings - Fork 5.2k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
first round of revisions based on comments more edits/revisions per more comments respond to comments Feedback from spiffxp and pwittrock Feedback from pwittrock, part 2 Feedback from pwittrock, round 3
- Loading branch information
zacharysarah
committed
Feb 19, 2019
1 parent
808d7ec
commit 8227bce
Showing
1 changed file
with
97 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,97 @@ | ||
# SIG Docs Charter | ||
|
||
This charter adheres to the conventions described in the [Kubernetes Charter README] and adheres to the Roles and Organization Management specified in [sig-governance]. | ||
|
||
## Scope | ||
|
||
SIG Docs publishes Kubernetes documentation on kubernetes.io. Kubernetes documentation includes: | ||
- Documentation of the core Kubernetes APIs | ||
- Core Kubernetes architecture | ||
- CLI tools shipped with the Kubernetes release | ||
|
||
Responsibility for creating feature documentation belongs to the developers and SIGs associated with a feature. This includes documentation for features, concepts, components, opinions, processes, etc. | ||
|
||
SIG Docs sets standards for feature documentation, provides clear paths for docs contribution, and [coordinates documentation updates][docs-release] during quarterly releases. | ||
|
||
SIG Docs maintains the Kubernetes website's infrastructure and tooling. | ||
|
||
SIG Docs creates subprojects as needed to handle specific aspects of Kubernetes documentation. | ||
|
||
### In scope | ||
|
||
SIG [readme] | ||
|
||
#### Code, Binaries and Services | ||
|
||
- The kubernetes.io website: | ||
|
||
- Infrastructure and tooling | ||
- Support and standards for internationalization (i18n) and localization (L10n) | ||
- Maintaining and applying the style guide to feature documentation and release notes | ||
- Reviewing and publishing release notes during quarterly release cycles | ||
- Generated reference documentation for: | ||
- The core Kubernetes APIs | ||
- Kubernetes command-line tools, including but not limited to kubectl | ||
- Kubernetes setup tools | ||
- The Federation API | ||
|
||
See Cross-cutting for limitations on how the SIG helps with related efforts on other projects. | ||
|
||
#### Cross-cutting and Externally Facing Processes | ||
|
||
- [Standards for content][standards]: style guide, contributor guide, PR reviews | ||
SIG Docs is not responsible for branding any content related to the Kubernetes organization. We are sometimes informally invited to consult on branding and design decisions, but we have no formal responsibility for such work. | ||
|
||
- [Coordinating docs contributions for quarterly releases][docs-release] | ||
|
||
- Kubernetes blog: | ||
SIG Docs hosts the Kubernetes blog and provides tooling and workflow support for publishing the blog, but does not directly review blog posts or work with blog contributors. | ||
|
||
- Site UX: | ||
SIG Docs organizes and revises technical content to improve UX and technical accuracy for the current and four most previous releases, based on: | ||
- user-reported issues | ||
- site analytics | ||
- content audits performed by SIG members | ||
|
||
- Other project documentation: | ||
SIG Docs is sometimes advises on Kubernetes components outside of the Kubernetes/Kubernetes GitHub repository, or on other Kubernetes subprojects, but is not responsible for the documentation of any of these components or projects. | ||
|
||
### Out of scope | ||
|
||
- SIG Docs is not responsible for documenting new technical content. | ||
|
||
SIG Docs reviews and coordinates feature documentation created by community members. | ||
|
||
SIG Docs sets standards for content creation, in the form of a style guide; offers feedback and review of new feature documentation; offers advice about information architecture for new features in the docs; and otherwise provides guidance and oversight to make sure that new feature documentation is maximally helpful to developers. | ||
|
||
SIG Docs is not responsible for creating new feature documentation. | ||
|
||
- Branding, logos, or brand style guides for Kubernetes | ||
|
||
## Roles and Organization Management | ||
|
||
SIG Docs adheres to the standards for roles and organization management as specified by [sig-governance]. This SIG opts in to updates and modifications to [sig-governance]. | ||
|
||
### Additional responsibilities of Chairs | ||
|
||
Chairs also serve as Tech Leads. | ||
|
||
### Deviations from [sig-governance] | ||
|
||
Per [readme]: | ||
|
||
- Meetings are weekly | ||
- Once per month, weekly meeting time changes for easier attendance from APAC contributors | ||
- Once per quarter, leads and other interested parties meet to discuss quarterly goals and achievements | ||
|
||
### Subproject Creation | ||
|
||
SIG Chairs can create subprojects without requiring member votes. | ||
|
||
|
||
|
||
[sig-governance]: https://github.com/kubernetes/community/blob/master/committee-steering/governance/sig-governance.md | ||
[readme]: https://github.com/kubernetes/community/tree/master/sig-docs | ||
[Kubernetes Charter README]: https://github.com/kubernetes/community/blob/master/committee-steering/governance/README.md | ||
[standards]: https://kubernetes.io/docs/contribute/ | ||
[docs-release]: https://github.com/kubernetes/sig-release/tree/master/release-team/role-handbooks/docs |