Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Create SIG Docs charter #3001

Merged
merged 1 commit into from
Feb 26, 2019
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
98 changes: 98 additions & 0 deletions sig-docs/charter.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,98 @@
# 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 creating each feature. This includes task-driven documentation for the feature itself and conceptual documentation about the feature.

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, tooling, and analytics.

SIG Docs is responsible for maintaining existing content and UX on the site.

SIG Docs creates subprojects as needed to handle specific aspects of Kubernetes documentation.

zacharysarah marked this conversation as resolved.
Show resolved Hide resolved
### In scope

SIG [readme]

#### Code, Binaries and Services

The kubernetes.io website, which includes:
* Site content and documentation
* [Content style guides][standards] and their application to feature documentation and release notes
* Processes for launching feature content and release notes during quarterly releases
* Site infrastructure (Hugo, Netlify) and tooling
* Site analytics (Google Analytics)
* Site styles and CSS
* 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
zacharysarah marked this conversation as resolved.
Show resolved Hide resolved
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
zacharysarah marked this conversation as resolved.
Show resolved Hide resolved

- SIG Docs is not responsible for creating new feature documentation.

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.

- 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