From 3b9806834e84e77685a48976d045979695d69278 Mon Sep 17 00:00:00 2001 From: Sean Sullivan Date: Wed, 1 Aug 2018 14:41:59 -0700 Subject: First pass of SIG CLI charter --- sig-cli/README.md | 10 +++++++++- sig-cli/charter.md | 50 ++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 59 insertions(+), 1 deletion(-) create mode 100644 sig-cli/charter.md (limited to 'sig-cli') diff --git a/sig-cli/README.md b/sig-cli/README.md index 6ed0140f..afc52843 100644 --- a/sig-cli/README.md +++ b/sig-cli/README.md @@ -10,6 +10,8 @@ To understand how this file is generated, see https://git.k8s.io/community/gener Covers kubectl and related tools. We focus on the development and standardization of the CLI framework and its dependencies, the establishment of conventions for writing CLI commands, POSIX compliance, and improving the command line tools from a developer and devops user experience and usability perspective. +The [charter](charter.md) defines the scope and governance of the CLI Special Interest Group. + ## Meetings * Regular SIG Meeting: [Wednesdays at 09:00 PT (Pacific Time)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit) (biweekly). [Convert to your timezone](http://www.thetimezoneconverter.com/?t=09:00&tz=PT%20%28Pacific%20Time%29). * [Meeting notes and Agenda](https://docs.google.com/document/d/1r0YElcXt6G5mOWxwZiXgGu_X6he3F--wKwg-9UBc29I/edit?usp=sharing). @@ -20,13 +22,19 @@ Covers kubectl and related tools. We focus on the development and standardizatio ### Chairs The Chairs of the SIG run operations and processes governing the SIG. +* Maciej Szulik (**[@soltysh](https://github.com/soltysh)**), Red Hat +* Sean Sullivan (**[@seans3](https://github.com/seans3)**), Google + +### Technical Leads +The technical leads provide the technical vision and leadership for the SIG. + * Maciej Szulik (**[@soltysh](https://github.com/soltysh)**), Red Hat * Phillip Wittrock (**[@pwittrock](https://github.com/pwittrock)**), Google -* Tony Ado (**[@AdoHe](https://github.com/AdoHe)**), Alibaba ## Emeritus Leads * Fabiano Franz (**[@fabianofranz](https://github.com/fabianofranz)**), Red Hat +* Tony Ado (**[@AdoHe](https://github.com/AdoHe)**), Alibaba ## Contact * [Slack](https://kubernetes.slack.com/messages/sig-cli) diff --git a/sig-cli/charter.md b/sig-cli/charter.md new file mode 100644 index 00000000..794c8e4f --- /dev/null +++ b/sig-cli/charter.md @@ -0,0 +1,50 @@ +# SIG CLI Charter + +This charter adheres to the conventions described in the [Kubernetes Charter README] and uses +the Roles and Organization Management outlined in [sig-governance]. + +## Scope + +The Command Line Interface SIG (SIG CLI) is responsible for kubectl and +related tools. This group focuses on command line tools and +libraries to interface with Kubernetes API's. + +### In scope + +SIG CLI section in [sigs.yaml] + +#### Code, Binaries and Services + +SIG CLI code include command line tools and binaries for working with Kubernetes +API's. Examples of these binaries include: kubectl and kustomize. + +### Out of scope + +SIG CLI is NOT responsible for defining the Kubernetes API that it +interfaces with. The Kubernetes API is the responsibility of SIG API Machinery. + +## Roles and Organization Management + +SIG CLI adheres to the Roles and Organization Management outlined in [sig-governance] +and opts-in to updates and modifications to [sig-governance]. + +### Deviations from [sig-governance] + +- In addition to Technical Leads, SIG CLI defines Emeritus Leads. These former + SIG CLI leaders *SHOULD* be available to provide historical perspective and + knowledge. +- SIG CLI defines the role of Test Health Maintainer. Contributors who have + successfully completed one test on-call rotation within the last six months as + shown in the test on-call schedule of the [Test Playbook] are included in this + group. Test Health Maintainers are SIG CLI Members. + +### Subproject Creation + +Option 1: by [SIG Technical Leads](https://github.com/kubernetes/community/blob/master/committee-steering/governance/sig-governance.md#L100) + + +[sig-governance]: https://github.com/kubernetes/community/blob/master/committee-steering/governance/sig-governance.md +[sigs.yaml]: https://github.com/kubernetes/community/blob/master/sigs.yaml#L487 +[Kubernetes Charter README]: https://github.com/kubernetes/community/blob/master/committee-steering/governance/README.md +[Test Playbook]: https://docs.google.com/document/d/1Z3teqtOLvjAtE-eo0G9tjyZbgNc6bMhYGZmOx76v6oM + -- cgit v1.2.3 From fe65b9272473d59b002edab51db30d33ae17f196 Mon Sep 17 00:00:00 2001 From: Sean Sullivan Date: Fri, 17 Aug 2018 13:53:41 -0700 Subject: Added link to README --- sig-cli/charter.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'sig-cli') diff --git a/sig-cli/charter.md b/sig-cli/charter.md index 794c8e4f..2422c8c5 100644 --- a/sig-cli/charter.md +++ b/sig-cli/charter.md @@ -16,7 +16,7 @@ SIG CLI section in [sigs.yaml] #### Code, Binaries and Services SIG CLI code include command line tools and binaries for working with Kubernetes -API's. Examples of these binaries include: kubectl and kustomize. +API's. Examples of these binaries include: [kubectl and kustomize]. ### Out of scope @@ -47,4 +47,4 @@ Option 1: by [SIG Technical Leads](https://github.com/kubernetes/community/blob/ [sigs.yaml]: https://github.com/kubernetes/community/blob/master/sigs.yaml#L487 [Kubernetes Charter README]: https://github.com/kubernetes/community/blob/master/committee-steering/governance/README.md [Test Playbook]: https://docs.google.com/document/d/1Z3teqtOLvjAtE-eo0G9tjyZbgNc6bMhYGZmOx76v6oM - +[kubectl and kustomize]: https://github.com/kubernetes/community/blob/master/sig-cli/README.md#subprojects -- cgit v1.2.3 From 8b2aac97167f84020eea78e9517806fa1dba64e2 Mon Sep 17 00:00:00 2001 From: Sean Sullivan Date: Fri, 17 Aug 2018 14:06:47 -0700 Subject: Moving leadership changes to another PR --- sig-cli/README.md | 10 +--------- 1 file changed, 1 insertion(+), 9 deletions(-) (limited to 'sig-cli') diff --git a/sig-cli/README.md b/sig-cli/README.md index afc52843..6ed0140f 100644 --- a/sig-cli/README.md +++ b/sig-cli/README.md @@ -10,8 +10,6 @@ To understand how this file is generated, see https://git.k8s.io/community/gener Covers kubectl and related tools. We focus on the development and standardization of the CLI framework and its dependencies, the establishment of conventions for writing CLI commands, POSIX compliance, and improving the command line tools from a developer and devops user experience and usability perspective. -The [charter](charter.md) defines the scope and governance of the CLI Special Interest Group. - ## Meetings * Regular SIG Meeting: [Wednesdays at 09:00 PT (Pacific Time)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit) (biweekly). [Convert to your timezone](http://www.thetimezoneconverter.com/?t=09:00&tz=PT%20%28Pacific%20Time%29). * [Meeting notes and Agenda](https://docs.google.com/document/d/1r0YElcXt6G5mOWxwZiXgGu_X6he3F--wKwg-9UBc29I/edit?usp=sharing). @@ -22,19 +20,13 @@ The [charter](charter.md) defines the scope and governance of the CLI Special In ### Chairs The Chairs of the SIG run operations and processes governing the SIG. -* Maciej Szulik (**[@soltysh](https://github.com/soltysh)**), Red Hat -* Sean Sullivan (**[@seans3](https://github.com/seans3)**), Google - -### Technical Leads -The technical leads provide the technical vision and leadership for the SIG. - * Maciej Szulik (**[@soltysh](https://github.com/soltysh)**), Red Hat * Phillip Wittrock (**[@pwittrock](https://github.com/pwittrock)**), Google +* Tony Ado (**[@AdoHe](https://github.com/AdoHe)**), Alibaba ## Emeritus Leads * Fabiano Franz (**[@fabianofranz](https://github.com/fabianofranz)**), Red Hat -* Tony Ado (**[@AdoHe](https://github.com/AdoHe)**), Alibaba ## Contact * [Slack](https://kubernetes.slack.com/messages/sig-cli) -- cgit v1.2.3 From 7ac26538679db25d565791f6d7cf4df9feacd0b6 Mon Sep 17 00:00:00 2001 From: Sean Sullivan Date: Fri, 24 Aug 2018 11:52:44 -0700 Subject: Addressed comments on scope; Removed sigs.yaml --- sig-cli/charter.md | 23 +++++++++++++---------- 1 file changed, 13 insertions(+), 10 deletions(-) (limited to 'sig-cli') diff --git a/sig-cli/charter.md b/sig-cli/charter.md index 2422c8c5..8ce0dd18 100644 --- a/sig-cli/charter.md +++ b/sig-cli/charter.md @@ -6,22 +6,24 @@ the Roles and Organization Management outlined in [sig-governance]. ## Scope The Command Line Interface SIG (SIG CLI) is responsible for kubectl and -related tools. This group focuses on command line tools and +related tools. This group focuses on general purpose command line tools and libraries to interface with Kubernetes API's. ### In scope -SIG CLI section in [sigs.yaml] +SIG CLI [README] #### Code, Binaries and Services -SIG CLI code include command line tools and binaries for working with Kubernetes -API's. Examples of these binaries include: [kubectl and kustomize]. +SIG CLI code include general purpose command line tools and binaries for working +with Kubernetes API's. Examples of these binaries include: [kubectl and kustomize]. ### Out of scope -SIG CLI is NOT responsible for defining the Kubernetes API that it -interfaces with. The Kubernetes API is the responsibility of SIG API Machinery. +SIG CLI is not responsible for command-line tools built and maintained by other +SIGs, such as kubeadm, which is owned by SIG Cluster Lifecycle. SIG CLI is not +responsible for defining the Kubernetes API that it interfaces with. The +Kubernetes API is the responsibility of SIG API Machinery. ## Roles and Organization Management @@ -32,7 +34,7 @@ and opts-in to updates and modifications to [sig-governance]. - In addition to Technical Leads, SIG CLI defines Emeritus Leads. These former SIG CLI leaders *SHOULD* be available to provide historical perspective and - knowledge. + domain knowledge. - SIG CLI defines the role of Test Health Maintainer. Contributors who have successfully completed one test on-call rotation within the last six months as shown in the test on-call schedule of the [Test Playbook] are included in this @@ -43,8 +45,9 @@ and opts-in to updates and modifications to [sig-governance]. Option 1: by [SIG Technical Leads](https://github.com/kubernetes/community/blob/master/committee-steering/governance/sig-governance.md#L100) -[sig-governance]: https://github.com/kubernetes/community/blob/master/committee-steering/governance/sig-governance.md -[sigs.yaml]: https://github.com/kubernetes/community/blob/master/sigs.yaml#L487 [Kubernetes Charter README]: https://github.com/kubernetes/community/blob/master/committee-steering/governance/README.md -[Test Playbook]: https://docs.google.com/document/d/1Z3teqtOLvjAtE-eo0G9tjyZbgNc6bMhYGZmOx76v6oM +[sig-governance]: https://github.com/kubernetes/community/blob/master/committee-steering/governance/sig-governance.md +[README]: https://github.com/kubernetes/community/blob/master/sig-cli/README.md [kubectl and kustomize]: https://github.com/kubernetes/community/blob/master/sig-cli/README.md#subprojects +[Test Playbook]: https://docs.google.com/document/d/1Z3teqtOLvjAtE-eo0G9tjyZbgNc6bMhYGZmOx76v6oM + -- cgit v1.2.3