# 2021 SIG Architecture Annual Report

## Operational

**How are you doing with operational tasks in sig-governance.md?**

**Is your README accurate? have a CONTRIBUTING.md file?**

- Yes, our README is accurate. We do not have a CONTRIBUTING.md file, and so will add one.

**All subprojects correctly mapped and listed in sigs.yaml?**

- Yes.

**What’s your meeting culture? Large/small, active/quiet, learnings? Meeting notes up to date? Are you keeping recordings up to date/trends in community members watching recordings?**

- Our bi-weekly meeting is normally well attended, with approximately 20 individuals on a typical day, though it varies from a handful of folks to 40 or 50 depending on topics.

- Subproject meetings are smaller, generally in the half dozen range.

**How does the group get updates, reports, or feedback from subprojects? Are there any springing up or being retired? Are OWNERS files up to date in these areas?**

- We have a rotating schedule of subproject updates in the bi-weekly community meeting. Our OWNERS files are up-to-date as well.

**How does the group get updates, reports, or feedback from working groups? Are there any springing up or being retired? Are OWNERS files up to date in these areas?**

- We have not been getting updates from the working groups on any regular cadence.
- We lost track of the WGs we sponsored. We will make it a priority to get updates in the next upcoming meetings.

**When was your last monthly community-wide update? (provide link to deck and/or recording)**

- [June, 2020](https://youtu.be/ObqQxRRl9RQ?t=2277) at Kubernetes Community Meeting. [Slides](https://docs.google.com/presentation/d/1NytMrpVYKzFo7rLcEEHnFl8zOx05fnjs3xBSZXVE0nI/edit?usp=sharing).
- [December, 2020](https://youtu.be/rnNqcUeCD8E) at KubeCon NA, published on YouTube. We do not have anything lined up for Kubecon EU. We will prioritize giving our next update in Kubecon NA.

## Membership

**Are all listed SIG leaders (chairs, tech leads, and subproject owners) active?**

- All SIG chairs are active and attend most bi-weekly full SIG meetings. We do not have separate tech leads.

- For the conformance subproject, all owners are active in PR review and meeting attendance.

- For the production readiness subproject, all owners are active in both KEP reviews and meetings.

- For the enhancements subproject, all owners are all active.

- For the API review subproject. There is no meetings as such. The subproject coordinates via a project board.

- For the code organization subproject, @dims and @liggitt run regular meetings and review PRs and issues, pulling in other owners as needed.

**How do you measure membership? By mailing list members, OWNERs, or something else?**

- Mailing list members, though based on bounces during calendar updates, there are quite a few out-of-date memberships.

**How does the group measure reviewer and approver bandwidth? Do you need help in any area now? What are you doing about it?**

- PRR assigns specific approvers to each KEP that is targeting a release. Therefore, we have a clear picture of how much each
approver must do each cycle. In 1.21, each approver reviewed 22 KEPs. for the 1.22 cycle, we have a new approver (@ehashman) to
help reduce the load on each approver. Go Elana!
- Code Organization is coming along. Though we haven't updated dep-approvers in a while. Currently the root OWNERS are a bottleneck as their time is limited for dependency updates. We have a new approval plugin that wiiiii

**Is there a healthy onboarding and growth path for contributors in your SIG? What are some activities that the group does to encourage this? What programs are you participating in to grow contributors throughout the contributor ladder?**

- SIG Architecture owns very little code. The API review and Production Readiness Review projects do have reviewers and approvers
for those specialized purposes. Each of those programs has a documented shadow program to add new reviewers and approvers.
- The main meeting itself is losing steam a bit. We could use more across the board attendance. We have to find ways to do this with better timely topics.
- The sub projects are in sustainable shape for the most part. We could use more people in conformance, code-organization, and PRR for sure.
- We want to rework the API reviews as well to make sure SIGs can for the most part do their own API reviews.
- The Enhancements subproject has some tooling code, and is a good place for newer folks to contribute. It has been quite active recently, and as a process-focused subproject is a place where program managers can be

**What programs do you participate in for new contributors?**
- Mainly through code-organization, we have a new mentee from LFX for example.
- We do need to grow more folks who can work across SIGs somehow. We might need to put together a mentoring program to help with this. One idea we had before of reading group for KEPs may need to be revived.

**Does the group have contributors from multiple companies/affiliations? Can end users/companies contribute in some way that they currently are not?**

- Yes. Our chairs are from three different companies. We have many participants and subproject owners from those same companies and others.

## Current initiatives and project health

- Please include links to KEPs and other supporting information that will be beneficial to multiple types of community members.

**What are initiatives that should be highlighted, lauded, shout out, that your group is proud of? Currently underway? What are some of the longer tail projects that your group is working on?**

- We are proud of the work of the conformance subproject in burning down the [list of API endpoints that were untested](https://apisnoop.cncf.io/conformance-progress).
- the code-organization has come a long way as well, helping coordinate updates to dependencies across various projects to help make our dependencies cleaner (example grpc update across etcd/containerd etc)
- PRR ([policy](https://github.com/kubernetes/community/blob/master/sig-architecture/production-readiness.md), [KEP](https://github.com/kubernetes/enhancements/tree/master/keps/sig-architecture/1194-prod-readiness)) was made mandatory in 1.21 and the PRR team reviewed 66 KEPs, improving the scalability and supportability, and ensuring monitoring and feature enablement is properly conducted to make features production ready.
- Policies to move features across the project to GA, including:
- [Conformance Without Beta](https://github.com/kubernetes/enhancements/tree/master/keps/sig-architecture/1333-conformance-without-beta)
- [Preventing Permabeta](https://github.com/kubernetes/enhancements/tree/master/keps/sig-architecture/1635-prevent-permabeta)

**Year to date KEP work review: What’s now stable? Beta? Alpha? Road to alpha?**

- We are working on updates to enhancements process to make it easier for everyone involved.

**What areas and/or subprojects does the group need the most help with?**

- Setting up a mentoring program to increase the number of folks who can work across SIGs.

**What's the average open days of a PR and Issue in your group? / what metrics does your group care about and/or measure?**

- We mostly care about landing changes for the conformance subproject as it directly affects every end user. That has been going well the last few cycles.

## TODO (this section below does not go into the annual report)

- Create contributing.md
- make list of WG sponsored and invite them to give an update
- Mentoring program (premise : increase one's ability to work across SIGs)
- Issue / Bug Triage
- Writing KEPs
- Writing Conformance tests
- Researching long term problems
- KEP reading club with Eddie's help
- Add feedback to [Annual Report retro doc](https://docs.google.com/document/d/1X7rQx4rC9FbpdLMI5C8FY9j4TmeH2m1aKy_i4kemHXo/edit)