From 1db679c3b2a50a636f5e440ee6dc42710023baaf Mon Sep 17 00:00:00 2001 From: Davanum Srinivas Date: Fri, 2 Nov 2018 17:48:22 -0400 Subject: Re-organize SIG-Arch sub-projects Change-Id: I2d398122f98528735fb193a80aea4305b44cdb90 --- sigs.yaml | 32 ++++++++++++++++++-------------- 1 file changed, 18 insertions(+), 14 deletions(-) diff --git a/sigs.yaml b/sigs.yaml index 9ace0cd9..2db4468a 100644 --- a/sigs.yaml +++ b/sigs.yaml @@ -233,28 +233,32 @@ sigs: - name: sig-architecture-test-failures description: Test Failures and Triage subprojects: - - name: api + - name: architecture-and-api-governance owners: + - https://raw.githubusercontent.com/kubernetes/community/master/contributors/design-proposals/architecture/OWNERS + - https://raw.githubusercontent.com/kubernetes-sigs/architecture-tracking/master/OWNERS - https://raw.githubusercontent.com/kubernetes/api/master/OWNERS - https://raw.githubusercontent.com/kubernetes/kubernetes/master/staging/src/k8s.io/api/OWNERS - - name: kubernetes-template-project + - name: conformance-definition owners: - - https://raw.githubusercontent.com/kubernetes/kubernetes-template-project/master/OWNERS - - name: spartakus + - https://raw.githubusercontent.com/kubernetes/kubernetes/master/test/conformance/testdata/OWNERS + - https://github.com/orgs/kubernetes/teams/cncf-conformance-wg + - name: kep-adoption-and-reviews + - https://raw.githubusercontent.com/kubernetes/community/master/keps/OWNERS owners: - - https://raw.githubusercontent.com/kubernetes-incubator/spartakus/master/OWNERS - - name: steering - owners: - - https://raw.githubusercontent.com/kubernetes/steering/master/OWNERS - - name: architecture-tracking - owners: - - https://raw.githubusercontent.com/kubernetes-sigs/architecture-tracking/master/OWNERS - - name: universal-utils + - name: code-organization owners: + - https://raw.githubusercontent.com/kubernetes/contrib/master/OWNERS # solely to steward moving code _out_ of here to more appropriate places - https://raw.githubusercontent.com/kubernetes/utils/master/OWNERS - - name: contrib # solely to steward moving code _out_ of here to more appropriate places + - https://raw.githubusercontent.com/kubernetes/kubernetes/master/vendor/OWNERS + - https://raw.githubusercontent.com/kubernetes/kubernetes/master/third_party/OWNERS + - https://raw.githubusercontent.com/kubernetes/kubernetes/master/staging/OWNERS + - name: steering owners: - - https://raw.githubusercontent.com/kubernetes/contrib/master/OWNERS + - https://raw.githubusercontent.com/kubernetes/steering/master/OWNERS + - https://raw.githubusercontent.com/kubernetes-incubator/spartakus/master/OWNERS + - https://raw.githubusercontent.com/kubernetes/kubernetes-template-project/master/OWNERS + - name: Auth dir: sig-auth mission_statement: > -- cgit v1.2.3 From 3a997f8568360cd3ba5ebd35bba3d41108fd720d Mon Sep 17 00:00:00 2001 From: Davanum Srinivas Date: Fri, 2 Nov 2018 17:53:56 -0400 Subject: Add details about each sub project in SIG-Arch Change-Id: Ie057ce4936dc8583c995355f61615dc8c831f6b2 --- sig-architecture/README.md | 43 ++++++++++++++++++++++++++++++++++++++----- 1 file changed, 38 insertions(+), 5 deletions(-) diff --git a/sig-architecture/README.md b/sig-architecture/README.md index 7daf1b82..12354dc2 100644 --- a/sig-architecture/README.md +++ b/sig-architecture/README.md @@ -77,12 +77,45 @@ Note that the links to display team membership will only work if you are a membe * [Charter](charter.md) -## Processes owned and tracked by the SIG +# Details about SIG-Architecture sub-projects -[Architecture Tracking Repository](https://github.com/kubernetes-sigs/architecture-tracking/) +## Architecture and API Governance + +Establishing and documenting design principles, documenting and evolving the system architecture, reviewing, curating, and documenting new extension patterns + +Establishing and documenting conventions for system and user-facing APIs, define and operate the APl review process, final API implementation consistency validation, co-own top-level API directories with API machinery; maintaining, evolving, and enforcing the deprecation policy + +* [Kubernetes Design and Architecture](https://github.com/kubernetes/community/blob/master/contributors/design-proposals/architecture/architecture.md) +* [Design principles](https://github.com/kubernetes/community/blob/master/contributors/design-proposals/architecture/principles.md) +* [API conventions](https://github.com/kubernetes/community/blob/master/contributors/devel/api-conventions.md) +* [API Review process](https://github.com/kubernetes/community/blob/master/sig-architecture/api-review-process.md) +* [Deprecation policy](https://kubernetes.io/docs/reference/deprecation-policy/) + +Please see the [Design documentation](https://github.com/kubernetes-sigs/architecture-tracking/projects/4) and [API Reviews](https://github.com/kubernetes-sigs/architecture-tracking/projects/3) tracking boards to follow the work of this sub-project. Please reach out to folks in the [OWNERS](https://github.com/kubernetes/community/blob/master/contributors/design-proposals/architecture/OWNERS) file if you are interested in joining this effort. + +## Conformance Definition + +Reviewing, approving, and driving changes to the conformance test suite; reviewing, guiding, and creating new conformance profiles + +* [Conformance Tests](https://github.com/kubernetes/kubernetes/blob/master/test/conformance/testdata/conformance.txt) +* [Test Guidelines](https://github.com/kubernetes/community/blob/master/contributors/devel/conformance-tests.md) + +Please see the [Conformance Test Review](https://github.com/kubernetes-sigs/architecture-tracking/projects/1) tracking board to follow the work for this sub-project. Please reach out to folks in the [OWNERS](https://github.com/kubernetes/kubernetes/blob/master/test/conformance/testdata/OWNERS) file if you are interested in joining this effort. There is a lot of overlap with the [Kubernetes Software Conformance Working Group](https://github.com/cncf/k8s-conformance/blob/master/README-WG.md) with this sub project as well. The github group [cncf-conformance-wg](https://github.com/orgs/kubernetes/teams/cncf-conformance-wg) enumerates the folks on this working group. Look for the `area/conformance` label in the kubernetes repositories to mark [issues](https://github.com/kubernetes/kubernetes/issues?q=is%3Aissue+is%3Aopen+label%3Aarea%2Fconformance) and [PRs](https://github.com/kubernetes/kubernetes/pulls?q=is%3Apr+is%3Aopen+label%3Aarea%2Fconformance) + +## KEP Adoption and Reviews + +Develop and drive technical enhancement review process + +* [KEP Process](https://github.com/kubernetes/community/blob/master/keps/0001-kubernetes-enhancement-proposal-process.md) +* [Template](https://github.com/kubernetes/community/blob/master/keps/0000-kep-template.md) + +Please see the [KEP Tracking](https://github.com/kubernetes-sigs/architecture-tracking/projects/2) board to follow the work of this sub-project. Please reach out to folks in the [OWNERS](https://github.com/kubernetes/community/blob/master/keps/OWNERS) file if you are interested in joining this effort. + +## Code Organization + +Overall code organization, including github repositories and branching methodology, top-level and pkg OWNERS of kubernetes/kubernetes, vendoring + +Please reach out to folks in the [OWNERS](https://github.com/kubernetes/kubernetes/blob/master/vendor/OWNERS) file if you are interested in joining this effort. -* [API Reviews](https://github.com/kubernetes-sigs/architecture-tracking/projects/3) -* [KEP Reviews](https://github.com/kubernetes-sigs/architecture-tracking/projects/2) -* [Conformance Test Review](https://github.com/kubernetes-sigs/architecture-tracking/projects/1) -- cgit v1.2.3 From dfa1892d8a699060ad9c06018a31ced9778c3da5 Mon Sep 17 00:00:00 2001 From: Davanum Srinivas Date: Fri, 2 Nov 2018 17:56:09 -0400 Subject: Fix typo in sigs.yaml and generate the README.md Change-Id: I02c5937a0d8e34811023a03fa9a004db6be9cbbd --- sig-architecture/README.md | 31 +++++++++++++++++-------------- sigs.yaml | 2 +- 2 files changed, 18 insertions(+), 15 deletions(-) diff --git a/sig-architecture/README.md b/sig-architecture/README.md index 12354dc2..3f2660d9 100644 --- a/sig-architecture/README.md +++ b/sig-architecture/README.md @@ -33,28 +33,31 @@ The Chairs of the SIG run operations and processes governing the SIG. ## Subprojects The following subprojects are owned by sig-architecture: -- **api** +- **architecture-and-api-governance** - Owners: + - https://raw.githubusercontent.com/kubernetes/community/master/contributors/design-proposals/architecture/OWNERS + - https://raw.githubusercontent.com/kubernetes-sigs/architecture-tracking/master/OWNERS - https://raw.githubusercontent.com/kubernetes/api/master/OWNERS - https://raw.githubusercontent.com/kubernetes/kubernetes/master/staging/src/k8s.io/api/OWNERS -- **kubernetes-template-project** - - Owners: - - https://raw.githubusercontent.com/kubernetes/kubernetes-template-project/master/OWNERS -- **spartakus** +- **conformance-definition** - Owners: - - https://raw.githubusercontent.com/kubernetes-incubator/spartakus/master/OWNERS -- **steering** - - Owners: - - https://raw.githubusercontent.com/kubernetes/steering/master/OWNERS -- **architecture-tracking** + - https://raw.githubusercontent.com/kubernetes/kubernetes/master/test/conformance/testdata/OWNERS + - https://github.com/orgs/kubernetes/teams/cncf-conformance-wg +- **kep-adoption-and-reviews** - Owners: - - https://raw.githubusercontent.com/kubernetes-sigs/architecture-tracking/master/OWNERS -- **universal-utils** + - https://raw.githubusercontent.com/kubernetes/community/master/keps/OWNERS +- **code-organization** - Owners: + - https://raw.githubusercontent.com/kubernetes/contrib/master/OWNERS - https://raw.githubusercontent.com/kubernetes/utils/master/OWNERS -- **contrib** + - https://raw.githubusercontent.com/kubernetes/kubernetes/master/vendor/OWNERS + - https://raw.githubusercontent.com/kubernetes/kubernetes/master/third_party/OWNERS + - https://raw.githubusercontent.com/kubernetes/kubernetes/master/staging/OWNERS +- **steering** - Owners: - - https://raw.githubusercontent.com/kubernetes/contrib/master/OWNERS + - https://raw.githubusercontent.com/kubernetes/steering/master/OWNERS + - https://raw.githubusercontent.com/kubernetes-incubator/spartakus/master/OWNERS + - https://raw.githubusercontent.com/kubernetes/kubernetes-template-project/master/OWNERS ## GitHub Teams diff --git a/sigs.yaml b/sigs.yaml index 2db4468a..4095d435 100644 --- a/sigs.yaml +++ b/sigs.yaml @@ -244,8 +244,8 @@ sigs: - https://raw.githubusercontent.com/kubernetes/kubernetes/master/test/conformance/testdata/OWNERS - https://github.com/orgs/kubernetes/teams/cncf-conformance-wg - name: kep-adoption-and-reviews - - https://raw.githubusercontent.com/kubernetes/community/master/keps/OWNERS owners: + - https://raw.githubusercontent.com/kubernetes/community/master/keps/OWNERS - name: code-organization owners: - https://raw.githubusercontent.com/kubernetes/contrib/master/OWNERS # solely to steward moving code _out_ of here to more appropriate places -- cgit v1.2.3