From 2b7aeeca812cf209c6900804edbb54e1f1f8a9e0 Mon Sep 17 00:00:00 2001 From: Brian Grant Date: Mon, 24 Jul 2017 09:16:44 -0700 Subject: Initial draft of SIG architecture charter. --- sig-architecture/README.md | 6 +++++- sig-architecture/charter.md | 40 ++++++++++++++++++++++++++++++++++++++++ sigs.yaml | 2 +- 3 files changed, 46 insertions(+), 2 deletions(-) create mode 100644 sig-architecture/charter.md diff --git a/sig-architecture/README.md b/sig-architecture/README.md index ba944a67..c933fb03 100644 --- a/sig-architecture/README.md +++ b/sig-architecture/README.md @@ -8,7 +8,7 @@ To understand how this file is generated, see generator/README.md. --> # Architecture SIG -The SIG would be intended to guide the design principles of Kubernetes, as well as provide a consistent body of expertise necessary to ensure architectural consistency over time. +The Architecture SIG maintains and evolves the design principles of Kubernetes, and provides a consistent body of expertise necessary to ensure architectural consistency over time. ## Meetings * [Mondays at 17:00 UTC](https://zoom.us/j/2018742972) (biweekly). [Convert to your timezone](http://www.thetimezoneconverter.com/?t=17:00&tz=UTC). @@ -25,4 +25,8 @@ Meeting notes and Agenda can be found [here](https://docs.google.com/document/d/ +## Additional materials + +* [Charter](charter.md) + diff --git a/sig-architecture/charter.md b/sig-architecture/charter.md new file mode 100644 index 00000000..04fd2ecf --- /dev/null +++ b/sig-architecture/charter.md @@ -0,0 +1,40 @@ +# SIG Architecture Charter + +This charter is a WIP. + +The Architecture SIG maintains and evolves the design principles of +Kubernetes, and provides a consistent body of expertise necessary to +ensure architectural consistency over time. + +The scope covers issues that span all the system's components, how +they fit together, how they interact, etc. + +Specific areas of focus include: + +* Defining the scope of the Kubernetes project + * [What is (and is not) Kubernetes](https://kubernetes.io/docs/concepts/overview/what-is-kubernetes/) +* Maintaining, evolving, and enforcing the deprecation policy + * [Deprecation policy](https://kubernetes.io/docs/reference/deprecation-policy/) +* Documenting and evolving the system architecture + * [Kubernetes Design and Architecture](https://github.com/kubernetes/community/blob/master/contributors/design-proposals/architecture.md) +* Defining and driving necessary extensibility points +* Establishing and documenting design principles + * [Design principles](https://github.com/kubernetes/community/blob/master/contributors/design-proposals/principles.md) +* Establishing and documenting conventions for system and user-facing APIs + * [API conventions](https://github.com/kubernetes/community/blob/master/contributors/devel/api-conventions.md) +* Developing necessary technical review processes, such as the proposal and API review processes +* Driving improvement of overall code organization, including github orgs and repositories +* Educating approvers/owners of other SIGs (e.g., by holding office hours) + +Out of scope: +* Issues specific to a particular component or functional area, which would be the purview + of some other SIG, except where they deviate from project-wide principles and conventions. +* [Release support policy](https://github.com/kubernetes/community/blob/master/contributors/design-proposals/versioning.md) + is owned by SIG Release + +TODO: +* Formalize decision processes +* Document initial reviewers and approvers +* Clarify criteria for areas out of scope for the SIG +* Document who owns client library, build, and release artifacts +* Document who owns conformance definition, profiles, etc. diff --git a/sigs.yaml b/sigs.yaml index 5cb86611..3bcd6566 100644 --- a/sigs.yaml +++ b/sigs.yaml @@ -49,7 +49,7 @@ sigs: - name: Architecture dir: sig-architecture mission_statement: > - The SIG would be intended to guide the design principles of Kubernetes, as well as provide a consistent + The Architecture SIG maintains and evolves the design principles of Kubernetes, and provides a consistent body of expertise necessary to ensure architectural consistency over time. leads: - name: Brian Grant -- cgit v1.2.3