From 7c795c64b12b4403b5da354d14a7b494dc8ca57a Mon Sep 17 00:00:00 2001 From: Paris Date: Tue, 27 Feb 2018 07:48:20 -0800 Subject: [PATCH 1/6] Create projects.md Create projects.md to list goals and projects that ContribEx is working on --- sig-contributor-experience/projects.md | 72 ++++++++++++++++++++++++++ 1 file changed, 72 insertions(+) create mode 100644 sig-contributor-experience/projects.md diff --git a/sig-contributor-experience/projects.md b/sig-contributor-experience/projects.md new file mode 100644 index 000000000..58d7c122f --- /dev/null +++ b/sig-contributor-experience/projects.md @@ -0,0 +1,72 @@ +# Projects and Goals + +This is a list of the projects and goals currently underway with Contributor Experience. Please submit a PR if you are adding your project to this list. To introduce a new project, attend a weekly meeting or drop a note to us on the mailing list - details can be found on our [README](README.md). + +Want to contribute? Take a look at this list and the "future" at the bottom. Thank you to all of our contributors for your hard work! + +## SIG Planning + +Project | Owner(s)/Lead(s) | Description | Q1, Q2, Later +---|---|---|--- +[Charter](https://github.com/kubernetes/community/pull/1847) | SIG Leads | Create our first Charter iteration | Q1 +Goals and Projects | SIG Leads | Create projects.md | Q1 +de-SPOF Community Management | @castrojo | eg: YouTube management | Ongoing + +## Mentoring +Launch a multi-tier strategy test for group mentoring, mentors on demand (meet our contributors), diversity (outreachy), and google summer of code (students) that promote all levels of the [contributor ladder](community-membership.md). + +Project | Owner(s)/Lead(s) | Description | Q1, Q2, Later +---|---|---|--- +[Group Mentoring](mentoring/group-mentoring.md) | @parispittman | Launch a test cohort that takes 10 current members to reviewer in 3 k8s repos/projects. Develop the learning and development workshops. | Q1 and ongoing +[Meet Our Contributors](mentoring/meet-our-contributors.md) | @parispittman | Monthly web series similar to user office hours that allows anyone to ask new and current contributors quetions about our process, ecosystem, or their stories in open source | Q1 - ongoing +[Outreachy](mentoring/README.md) | @parispittman | Document new features, create new conceptual content, create new user paths | Q1 +[Google Summer of Code](mentoring/google-summer-of-code.md) | @nikitha | Kubernetes participation in Google Summer of Code for students | Q1 - ongoing +["Buddy" Program](https://github.com/kubernetes/community/issues/1803) | @parispittman, @chrisshort | 1 hour 1:1 sessions for new and current contributors to have dedicated time; meet our contributors but personal | Q2 + +## Contributor Documentation, Workflow, and Automation +Ensure the contribution process is well documented, discoverable, and consistent across repos to deliver the best contributor experience. Provide sufficient automation that direct write access to repos is no longer required. + +Project | Owner(s)/Lead(s) | Description | Q1, Q2, Later +---|---|---|--- +[Contributor Guide](contributors/guide) | @castrojo | make contributor onboarding easier; first version | Q1 +Developer Guide | needs owner | a comprehensive guide for upstream developers to be a part of the Contributor Guide | Q2 +[New Community Website](https://github.com/kubernetes/community/issues/1819) | A new home for all things community -documentation, KEPs, Mentoring, + more | Q2 - ongoing +[Label Documentation](https://gist.github.com/spiffxp/24937d8478853054c088ffc298021214) | @spiffxp | GitHub is rolling out a label description feature in the future; this is to document the label descriptions for contributors | Q1 +Issue Hygeine | @spzala | Produce clear understanding and documentation of issue hygeine | Q1 +PR Descriptions | @grodrigues, @spiffxp | Automation allowing people to edit pr descriptions for tldr or correct issue / pr; release notes based (design). Define remaining work to be done. | Q1 - ongoing +Cherry Pick Process | @spiffxp | Design and Prototype | Q2 + +## Project-wide Communication Channels +Build, curate, moderate, and make project wide communication channels accessible. + +Project | Owner(s)/Lead(s) | Description | Q1, Q2, Later +---|---|---|--- +[Slack Admin Guidelines](communication/slack-guidelines.md) | @parispittman | first iteration of guidelines to administer slack for 30k+ users | Q1 +[Weekly K8s Community Meeting](events/community-meeting.md) | @castrojo, @parispittman | Smooth out weekly community meeting and make adjustments | Ongoing +Roadshow | @parispittman | ContribEx to visit all SIG/WG meetings to deliver messages and collect feedback | Ongoing +[Documentation](communication/README.md) | @parispittman, @castrojo | Create new communication directory and include all information about our communication channels | Q1, 2 + +## DevStats +https://k8s.devstats.cncf.io; work devstats into making it the one stop shop for all things upstream Kubernetes data. Looking for a Product Owner. + +Project | Owner(s)/Lead(s) | Description | Q1, Q2, Later +---|---|---|--- +Graph of the Week | @castrojo | Present at least two graphs a month with explanation about why we care to the community meeting | Ongoing +[User Guide](https://github.com/cncf/devstats/issues/35) | @jberkus, @parispittman, @tpepper | Create a v1 README for DevStats that explains each chart | Q2 +Data validation | @jberkus | Ensure that the data that running through the tool is accurate and aggregating the right information + +## Events +Curate and produce the best contributor face to face gatherings. + +Project | Owner(s)/Lead(s) | Description | Q1, Q2, Later +---|---|---|--- +[KubeCon](https://events.linuxfoundation.org/events/kubecon-cloudnativecon-europe-2018/co-located-events/kubernetes-contributor-summit/) | @castrojo, @jberkus, @parispittman | Ensure contributors have great content at the event(s)| Q2, Q4 +KubeCon ContribEx Update and Deep Dive | @parispittman, leads | Run the 30 min update and 30 min deep dive at the event | Q2, Q4 + + +## FUTURE +This projects do not have an owner and have not started yet; however, we would like to get them on the slate for sometime this year. +Project | Description +---|--- +Automation of new membership | Current process is emailing a googlegroup and an org owner adds person to GH org +Audit schedule | Create an audit schedule to make sure all communication pipelines are up and running smoothly eg: check that google group mailing lists have back up owners/maintainers, make sure meetings are following the calendar process, etc. From 8736fbb593e53d77c789ba8cdab3d5ae9b606188 Mon Sep 17 00:00:00 2001 From: Paris Date: Tue, 27 Feb 2018 07:59:25 -0800 Subject: [PATCH 2/6] Update projects.md Fixed wild table at the bottom for future section --- sig-contributor-experience/projects.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/sig-contributor-experience/projects.md b/sig-contributor-experience/projects.md index 58d7c122f..01704a71e 100644 --- a/sig-contributor-experience/projects.md +++ b/sig-contributor-experience/projects.md @@ -66,7 +66,8 @@ KubeCon ContribEx Update and Deep Dive | @parispittman, leads | Run the 30 min u ## FUTURE This projects do not have an owner and have not started yet; however, we would like to get them on the slate for sometime this year. + Project | Description ----|--- +---|--- Automation of new membership | Current process is emailing a googlegroup and an org owner adds person to GH org Audit schedule | Create an audit schedule to make sure all communication pipelines are up and running smoothly eg: check that google group mailing lists have back up owners/maintainers, make sure meetings are following the calendar process, etc. From 683089b6bbe8f040c1061e8ad544ad7c0485cbe6 Mon Sep 17 00:00:00 2001 From: Paris Date: Mon, 5 Mar 2018 23:39:18 -0800 Subject: [PATCH 3/6] Update projects.md Made suggested edits from reviews --- sig-contributor-experience/projects.md | 45 +++++++++++++++----------- 1 file changed, 26 insertions(+), 19 deletions(-) diff --git a/sig-contributor-experience/projects.md b/sig-contributor-experience/projects.md index 01704a71e..21fb3e58d 100644 --- a/sig-contributor-experience/projects.md +++ b/sig-contributor-experience/projects.md @@ -8,52 +8,59 @@ Want to contribute? Take a look at this list and the "future" at the bottom. Tha Project | Owner(s)/Lead(s) | Description | Q1, Q2, Later ---|---|---|--- -[Charter](https://github.com/kubernetes/community/pull/1847) | SIG Leads | Create our first Charter iteration | Q1 -Goals and Projects | SIG Leads | Create projects.md | Q1 +[Charter](charter.md) | SIG Leads | Create our first Charter iteration | Q1 +Projects and Goals (this doc) | @parispittman | Create projects.md | Q1 de-SPOF Community Management | @castrojo | eg: YouTube management | Ongoing ## Mentoring -Launch a multi-tier strategy test for group mentoring, mentors on demand (meet our contributors), diversity (outreachy), and google summer of code (students) that promote all levels of the [contributor ladder](community-membership.md). +Launch a multi-tier strategy test that promote all levels of the [contributor ladder](/community-membership.md) and diversity throughout the project. Project | Owner(s)/Lead(s) | Description | Q1, Q2, Later ---|---|---|--- -[Group Mentoring](mentoring/group-mentoring.md) | @parispittman | Launch a test cohort that takes 10 current members to reviewer in 3 k8s repos/projects. Develop the learning and development workshops. | Q1 and ongoing -[Meet Our Contributors](mentoring/meet-our-contributors.md) | @parispittman | Monthly web series similar to user office hours that allows anyone to ask new and current contributors quetions about our process, ecosystem, or their stories in open source | Q1 - ongoing -[Outreachy](mentoring/README.md) | @parispittman | Document new features, create new conceptual content, create new user paths | Q1 -[Google Summer of Code](mentoring/google-summer-of-code.md) | @nikitha | Kubernetes participation in Google Summer of Code for students | Q1 - ongoing +[Group Mentoring](/mentoring/group-mentoring.md) | @parispittman | Launch a test cohort that takes 10 current members to reviewer in 3 k8s repos/projects (kops, kubeadm, workload API). Develop the learning and development workshops. | Q1 and ongoing +[Meet Our Contributors](/mentoring/meet-our-contributors.md) | @parispittman | Monthly web series similar to user office hours that allows anyone to ask new and current contributors questions about our process, ecosystem, or their stories in open source | Q1 - ongoing +[Outreachy](/mentoring/README.md) | @parispittman | Document new features, create new conceptual content, create new user paths | Q1 +[Google Summer of Code](/mentoring/google-summer-of-code.md) | @nikhita | Kubernetes participation in Google Summer of Code for students | Q1 - ongoing ["Buddy" Program](https://github.com/kubernetes/community/issues/1803) | @parispittman, @chrisshort | 1 hour 1:1 sessions for new and current contributors to have dedicated time; meet our contributors but personal | Q2 -## Contributor Documentation, Workflow, and Automation -Ensure the contribution process is well documented, discoverable, and consistent across repos to deliver the best contributor experience. Provide sufficient automation that direct write access to repos is no longer required. +## Contributor Documentation +Ensure the contribution process is well documented, discoverable, and consistent across repos to deliver the best contributor experience. Project | Owner(s)/Lead(s) | Description | Q1, Q2, Later ---|---|---|--- -[Contributor Guide](contributors/guide) | @castrojo | make contributor onboarding easier; first version | Q1 +[Contributor Guide](/contributors/guide) | @castrojo | Make contributor onboarding easier; first version | Q1 Developer Guide | needs owner | a comprehensive guide for upstream developers to be a part of the Contributor Guide | Q2 -[New Community Website](https://github.com/kubernetes/community/issues/1819) | A new home for all things community -documentation, KEPs, Mentoring, + more | Q2 - ongoing +[New Community/Contributor Website](https://github.com/kubernetes/community/issues/1819) | @castrojo | A new home for all things community -documentation, KEPs, Mentoring, + more | Q2 - ongoing [Label Documentation](https://gist.github.com/spiffxp/24937d8478853054c088ffc298021214) | @spiffxp | GitHub is rolling out a label description feature in the future; this is to document the label descriptions for contributors | Q1 Issue Hygeine | @spzala | Produce clear understanding and documentation of issue hygeine | Q1 -PR Descriptions | @grodrigues, @spiffxp | Automation allowing people to edit pr descriptions for tldr or correct issue / pr; release notes based (design). Define remaining work to be done. | Q1 - ongoing + + +## Contributor Workflow and Automation +Ensure contributors have a smooth and similar process across repos to deliver the best contributor experience. Provide sufficient automation so that direct write access to repos is no longer required. + +Project | Owner(s)/Lead(s) | Description | Q1, Q2, Later +---|---|---|--- Cherry Pick Process | @spiffxp | Design and Prototype | Q2 +PR Descriptions | @grodrigues3, @spiffxp | Automation allowing people to edit pr descriptions for tldr or correct issue / pr; release notes based (design). Define remaining work to be done. | Q1 - ongoing ## Project-wide Communication Channels Build, curate, moderate, and make project wide communication channels accessible. Project | Owner(s)/Lead(s) | Description | Q1, Q2, Later ---|---|---|--- -[Slack Admin Guidelines](communication/slack-guidelines.md) | @parispittman | first iteration of guidelines to administer slack for 30k+ users | Q1 -[Weekly K8s Community Meeting](events/community-meeting.md) | @castrojo, @parispittman | Smooth out weekly community meeting and make adjustments | Ongoing +[Slack Admin Guidelines](/communication/slack-guidelines.md) | @parispittman | First iteration of guidelines to administer slack for 30k+ users | Q1 +[Weekly K8s Community Meeting](/events/community-meeting.md) | @castrojo, @parispittman | Smooth out weekly community meeting and make adjustments | Ongoing Roadshow | @parispittman | ContribEx to visit all SIG/WG meetings to deliver messages and collect feedback | Ongoing -[Documentation](communication/README.md) | @parispittman, @castrojo | Create new communication directory and include all information about our communication channels | Q1, 2 +[Documentation](/communication/README.md) | @parispittman, @castrojo | Create new communication directory and include all information about our communication channels | Q1, Q2 ## DevStats -https://k8s.devstats.cncf.io; work devstats into making it the one stop shop for all things upstream Kubernetes data. Looking for a Product Owner. +https://k8s.devstats.cncf.io; work devstats into making it the one stop shop for all things upstream Kubernetes data. @phillels is the product owner. Project | Owner(s)/Lead(s) | Description | Q1, Q2, Later ---|---|---|--- -Graph of the Week | @castrojo | Present at least two graphs a month with explanation about why we care to the community meeting | Ongoing +Graph of the Week | @castrojo, @phillels | Present at least two graphs a month with explanation about why we care to the community meeting | Ongoing [User Guide](https://github.com/cncf/devstats/issues/35) | @jberkus, @parispittman, @tpepper | Create a v1 README for DevStats that explains each chart | Q2 -Data validation | @jberkus | Ensure that the data that running through the tool is accurate and aggregating the right information +Data validation | @jberkus | Ensure that the data that running through the tool is accurate and aggregating the right information | ongoing ## Events Curate and produce the best contributor face to face gatherings. @@ -65,7 +72,7 @@ KubeCon ContribEx Update and Deep Dive | @parispittman, leads | Run the 30 min u ## FUTURE -This projects do not have an owner and have not started yet; however, we would like to get them on the slate for sometime this year. +These projects do not have an owner and have not started yet; however, we would like to get them on the slate for sometime this year. Project | Description ---|--- From 73fa6a36b709cd115c63b8411cf5614ade4816ee Mon Sep 17 00:00:00 2001 From: Paris Date: Thu, 22 Mar 2018 18:12:05 -0700 Subject: [PATCH 4/6] Update projects.md Added temp header/note, added an owner, and changed some wording --- sig-contributor-experience/projects.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/sig-contributor-experience/projects.md b/sig-contributor-experience/projects.md index 21fb3e58d..25894d1d6 100644 --- a/sig-contributor-experience/projects.md +++ b/sig-contributor-experience/projects.md @@ -1,5 +1,7 @@ # Projects and Goals +*note - this is a temporary file until we can figure out a better project management solution.* + This is a list of the projects and goals currently underway with Contributor Experience. Please submit a PR if you are adding your project to this list. To introduce a new project, attend a weekly meeting or drop a note to us on the mailing list - details can be found on our [README](README.md). Want to contribute? Take a look at this list and the "future" at the bottom. Thank you to all of our contributors for your hard work! @@ -29,8 +31,8 @@ Ensure the contribution process is well documented, discoverable, and consistent Project | Owner(s)/Lead(s) | Description | Q1, Q2, Later ---|---|---|--- [Contributor Guide](/contributors/guide) | @castrojo | Make contributor onboarding easier; first version | Q1 -Developer Guide | needs owner | a comprehensive guide for upstream developers to be a part of the Contributor Guide | Q2 -[New Community/Contributor Website](https://github.com/kubernetes/community/issues/1819) | @castrojo | A new home for all things community -documentation, KEPs, Mentoring, + more | Q2 - ongoing +[Developer Guide](https://github.com/kubernetes/community/issues/1919) | @ryanj | a comprehensive guide for upstream developers to be a part of the Contributor Guide | Q2 +[New Contributor Website](https://github.com/kubernetes/community/issues/1819) | @castrojo | A new home for all things community -documentation, KEPs, Mentoring, + more | Q2 - ongoing [Label Documentation](https://gist.github.com/spiffxp/24937d8478853054c088ffc298021214) | @spiffxp | GitHub is rolling out a label description feature in the future; this is to document the label descriptions for contributors | Q1 Issue Hygeine | @spzala | Produce clear understanding and documentation of issue hygeine | Q1 @@ -51,7 +53,7 @@ Project | Owner(s)/Lead(s) | Description | Q1, Q2, Later [Slack Admin Guidelines](/communication/slack-guidelines.md) | @parispittman | First iteration of guidelines to administer slack for 30k+ users | Q1 [Weekly K8s Community Meeting](/events/community-meeting.md) | @castrojo, @parispittman | Smooth out weekly community meeting and make adjustments | Ongoing Roadshow | @parispittman | ContribEx to visit all SIG/WG meetings to deliver messages and collect feedback | Ongoing -[Documentation](/communication/README.md) | @parispittman, @castrojo | Create new communication directory and include all information about our communication channels | Q1, Q2 +[Communication Documentation](/communication/README.md) | @parispittman, @castrojo | Create new communication directory and include all information about our communication channels | Q1, Q2 ## DevStats https://k8s.devstats.cncf.io; work devstats into making it the one stop shop for all things upstream Kubernetes data. @phillels is the product owner. From e0d70d8cea8b715d60de431376cf07df6f4c2107 Mon Sep 17 00:00:00 2001 From: Paris Date: Mon, 2 Apr 2018 16:05:52 -0700 Subject: [PATCH 5/6] Update projects.md fixed spelling error where test was failing --- sig-contributor-experience/projects.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sig-contributor-experience/projects.md b/sig-contributor-experience/projects.md index 25894d1d6..453e5ce83 100644 --- a/sig-contributor-experience/projects.md +++ b/sig-contributor-experience/projects.md @@ -34,7 +34,7 @@ Project | Owner(s)/Lead(s) | Description | Q1, Q2, Later [Developer Guide](https://github.com/kubernetes/community/issues/1919) | @ryanj | a comprehensive guide for upstream developers to be a part of the Contributor Guide | Q2 [New Contributor Website](https://github.com/kubernetes/community/issues/1819) | @castrojo | A new home for all things community -documentation, KEPs, Mentoring, + more | Q2 - ongoing [Label Documentation](https://gist.github.com/spiffxp/24937d8478853054c088ffc298021214) | @spiffxp | GitHub is rolling out a label description feature in the future; this is to document the label descriptions for contributors | Q1 -Issue Hygeine | @spzala | Produce clear understanding and documentation of issue hygeine | Q1 +Issue hygiene | @spzala | Produce clear understanding and documentation of issue hygeine | Q1 ## Contributor Workflow and Automation From e1363f07f0f5abaf0129f4f1d7d50d3851106efa Mon Sep 17 00:00:00 2001 From: Paris Date: Mon, 2 Apr 2018 16:31:51 -0700 Subject: [PATCH 6/6] Update projects.md fixed another spelling error --- sig-contributor-experience/projects.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sig-contributor-experience/projects.md b/sig-contributor-experience/projects.md index 453e5ce83..bf1065613 100644 --- a/sig-contributor-experience/projects.md +++ b/sig-contributor-experience/projects.md @@ -34,7 +34,7 @@ Project | Owner(s)/Lead(s) | Description | Q1, Q2, Later [Developer Guide](https://github.com/kubernetes/community/issues/1919) | @ryanj | a comprehensive guide for upstream developers to be a part of the Contributor Guide | Q2 [New Contributor Website](https://github.com/kubernetes/community/issues/1819) | @castrojo | A new home for all things community -documentation, KEPs, Mentoring, + more | Q2 - ongoing [Label Documentation](https://gist.github.com/spiffxp/24937d8478853054c088ffc298021214) | @spiffxp | GitHub is rolling out a label description feature in the future; this is to document the label descriptions for contributors | Q1 -Issue hygiene | @spzala | Produce clear understanding and documentation of issue hygeine | Q1 +Issue hygiene | @spzala | Produce clear understanding and documentation of issue hygiene | Q1 ## Contributor Workflow and Automation