Link subproject descriptions, update conformance owners

2 files changed, 12 insertions, 2 deletions

diff --git a/sig-architecture/README.md b/sig-architecture/README.md
index 3f2660d9..87aa8b05 100644
--- a/sig-architecture/README.md
+++ b/sig-architecture/README.md
@@ -34,19 +34,23 @@ The Chairs of the SIG run operations and processes governing the SIG.
 
 The following subprojects are owned by sig-architecture:
 - **architecture-and-api-governance**
+  - Description: [Described below](#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
 - **conformance-definition**
+  - Description: [Described below](#conformance-definition)
   - Owners:
     - https://raw.githubusercontent.com/kubernetes/kubernetes/master/test/conformance/testdata/OWNERS
-    - https://github.com/orgs/kubernetes/teams/cncf-conformance-wg
+    - https://raw.githubusercontent.com/kubernetes/kubernetes/master/test/conformance/OWNERS
 - **kep-adoption-and-reviews**
+  - Description: [Described below](#kep-adoption-and-reviews)
   - Owners:
     - https://raw.githubusercontent.com/kubernetes/community/master/keps/OWNERS
 - **code-organization**
+  - Description: [Described below](#code-organization)
   - Owners:
     - https://raw.githubusercontent.com/kubernetes/contrib/master/OWNERS
     - https://raw.githubusercontent.com/kubernetes/utils/master/OWNERS
@@ -54,6 +58,7 @@ The following subprojects are owned by sig-architecture:
     - https://raw.githubusercontent.com/kubernetes/kubernetes/master/third_party/OWNERS
     - https://raw.githubusercontent.com/kubernetes/kubernetes/master/staging/OWNERS
 - **steering**
+  - Description: Placeholder until sigs.yaml supports committees as first-class groups. These repos are owned by the kubernetes steering committee, which is a wholly separate entity from SIG Architecture
   - Owners:
     - https://raw.githubusercontent.com/kubernetes/steering/master/OWNERS
     - https://raw.githubusercontent.com/kubernetes-incubator/spartakus/master/OWNERS
diff --git a/sigs.yaml b/sigs.yaml
index f1a9c3bb..541b81f3 100644
--- a/sigs.yaml
+++ b/sigs.yaml
@@ -234,19 +234,23 @@ sigs:
         description: Test Failures and Triage
     subprojects:
     - name: architecture-and-api-governance
+      description: "[Described below](#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: conformance-definition
+      description: "[Described below](#conformance-definition)"
       owners:
       - https://raw.githubusercontent.com/kubernetes/kubernetes/master/test/conformance/testdata/OWNERS
-      - https://github.com/orgs/kubernetes/teams/cncf-conformance-wg
+      - https://raw.githubusercontent.com/kubernetes/kubernetes/master/test/conformance/OWNERS
     - name: kep-adoption-and-reviews
+      description: "[Described below](#kep-adoption-and-reviews)"
       owners:
       - https://raw.githubusercontent.com/kubernetes/community/master/keps/OWNERS
     - name: code-organization
+      description: "[Described below](#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
@@ -254,6 +258,7 @@ sigs:
       - https://raw.githubusercontent.com/kubernetes/kubernetes/master/third_party/OWNERS
       - https://raw.githubusercontent.com/kubernetes/kubernetes/master/staging/OWNERS
     - name: steering
+      description: Placeholder until sigs.yaml supports committees as first-class groups. These repos are owned by the kubernetes steering committee, which is a wholly separate entity from SIG Architecture
       owners:
       - https://raw.githubusercontent.com/kubernetes/steering/master/OWNERS
       - https://raw.githubusercontent.com/kubernetes-incubator/spartakus/master/OWNERS