Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update Mentoring Landing Page #8023

Draft
wants to merge 8 commits into
base: master
Choose a base branch
from
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
78 changes: 78 additions & 0 deletions .github/workflows/hugo.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,78 @@
# Sample workflow for building and deploying a Hugo site to GitHub Pages
name: Deploy Hugo site to Pages

on:
# Runs on pushes targeting the default branch
push:
branches:
- main

# Allows you to run this workflow manually from the Actions tab
workflow_dispatch:

# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
permissions:
contents: read
pages: write
id-token: write

# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
concurrency:
group: "pages"
cancel-in-progress: false

# Default to bash
defaults:
run:
shell: bash

jobs:
# Build job
build:
runs-on: ubuntu-latest
env:
HUGO_VERSION: 0.128.0
steps:
- name: Install Hugo CLI
run: |
wget -O ${{ runner.temp }}/hugo.deb https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-amd64.deb \
&& sudo dpkg -i ${{ runner.temp }}/hugo.deb
- name: Install Dart Sass
run: sudo snap install dart-sass
- name: Checkout
uses: actions/checkout@v4
with:
submodules: recursive
fetch-depth: 0
- name: Setup Pages
id: pages
uses: actions/configure-pages@v5
- name: Install Node.js dependencies
run: "[[ -f package-lock.json || -f npm-shrinkwrap.json ]] && npm ci || true"
- name: Build with Hugo
env:
HUGO_CACHEDIR: ${{ runner.temp }}/hugo_cache
HUGO_ENVIRONMENT: production
TZ: America/Los_Angeles
run: |
hugo \
--gc \
--minify \
--baseURL "${{ steps.pages.outputs.base_url }}/"
- name: Upload artifact
uses: actions/upload-pages-artifact@v3
with:
path: ./public

# Deployment job
deploy:
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
runs-on: ubuntu-latest
needs: build
steps:
- name: Deploy to GitHub Pages
id: deployment
uses: actions/deploy-pages@v4
57 changes: 26 additions & 31 deletions mentoring/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,57 +5,51 @@ description: |
An index of Kubernetes Mentoring programs, initiatives, and resources.
---

# Kubernetes Upstream Mentoring Programs
# Kubernetes Mentoring Programs

This page indexes all of the mentoring initiatives for contributing to the Kubernetes project. For end user mentoring initiatives, check out KubeCon and other CNCF events and programs.

---

We understand that everyone has different learning styles and we want to support
as many of those as possible. Mentoring is vital to the growth of an individual
and organization of every kind. For Kubernetes, the larger the project becomes
, it's necessary to keep a continuous pipeline of quality contributors and we want you to hang around!
and organization of every kind. For Kubernetes, the larger the project becomes,
it's necessary to keep a continuous pipeline of quality contributors and we want you to hang around!

## Current mentoring activities:
## Resources
- [New Contributors Guide](https://docs.google.com/presentation/d/1WO7vj33cVy1-rOav3CevAGrw97VrbIAFo_SQXbUwy28/edit#slide=id.g2f2865a3246_0_63)
- [Mentor Guides](/mentoring/mentors/mentor-guide.md)
- [Mentee Guides](/mentoring/mentees/group-mentee-guide.md)
- [SIG Office Hours](/mentoring/resources/office-hours.md)

Please reach out to #sig-contribex on slack or come to a mentoring meeting to get involved in planning //TODO add contribex README when this is updated

SIG's office hours / mentoring

- [Office hours / mentoring](/mentoring/programs/office-hours.md)

Long Term Contributor Ladder Growth

- Through [Group Mentoring Cohorts](/mentoring/programs/group-mentoring.md)

Specific topics and activities
## Programs

- [The 1:1 Hour](/mentoring/programs/the1-on-1hour.md)
| Program | Status | Target Date |
|------------------------------------------------------------------------|--------------------------|-------------------------------------------------------------------------------|
| [Group Mentoring Cohorts](/mentoring/mentors/group-mentoring.md) | **Planning in progress** | [Sept-Nov](/mentoring/programs/2024/groupmentorship/group-mentor-planning.md) |

Role based shadow programs

- [List of programs](/mentoring/programs/shadow-roles.md)
### Self Paced
- [Contributor Workshop](/mentoring/programs/contributor-workshop/README.md)
- [Videos of New Contributor Workshop](https://www.youtube.com/playlist?list=PL69nYSiGNLP3M5X7stuD7N4r3uP2PZQUx)

Students
### Role based shadow programs

- [Google Summer of Code](/mentoring/programs/google-summer-of-code.md)
- [List of programs](/mentoring/programs/2024/shadow-roles.md)

1:1 full-time mentoring
### Mentoring Events

- [LFX Mentorship](/mentoring/programs/lfx-mentorship.md)

Tech Writers
- Pod Mentoring! [aka group mentoring](/mentoring/programs/archive/mentoring-events.md)

- [Google Season of Docs](/mentoring/programs/google-season-of-docs.md)
### External programs
- [LFX Mentorship](/mentoring/processes/lfx-mentorship.md)

Groups Traditionally Underrepresented in Tech
## Archive
- [Mentoring Programs](/mentoring/programs/archive/README.md)

- [Outreachy](/mentoring/programs/outreachy.md)
Please reach out to #sig-contribex on slack or come to a mentoring meeting to get involved in planning //TODO add contribex README when this is updated
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Are we planning to re-start the Mentoring Subproject Meetings?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That was actually on the original page - I just moved it. Although in saying that, and after speaking to Paris, it does seem we will need some meetings.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Basically, I've updated the landing page to make it "current", and restructured the folder structure. I'm going to add screen shots or push my changes to a personal space so it can be reviewed

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Before and Proposed (for review) landing pages....
LandingPage-Current
LandingPage-Proposed

Basically removed anything that isn't current, added a plan (which very much needs discussion), and made some other updates for the new contribution guide.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Folder Structure.
communityMentoring-CurrentFolderLayout
communityMentoring-ProposedFolderLayout

Here, I just tried to organize it (and archive the "old" pages")

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Also added a new plan which I want to discuss:

groupMentorPlanning

  • one change to the contributor-site (Land page)
  • several changes to the community/mentoring github folder structure and one new page (planning)


In person

- [Videos of New Contributor Workshop](https://www.youtube.com/playlist?list=PL69nYSiGNLP3M5X7stuD7N4r3uP2PZQUx)
- Pod Mentoring! [aka group mentoring](/mentoring/programs/mentoring-events.md)

#### Inspiration and Thanks

Expand All @@ -65,9 +59,10 @@ This is not an out of the box program but was largely inspired by the following:
- [Apache Mentoring Programme](https://community.apache.org/mentoringprogramme.html)
- [exercism.io](https://github.com/OperationCode/exercism-io-mentoring)
- [Google Summer of Code](https://developers.google.com/open-source/gsoc/)
- [LFX Mentorshop](https://github.com/cncf/mentoring)
- [Outreachy](https://www.outreachy.org/)
- [OpenStack Mentoring](https://wiki.openstack.org/wiki/Mentoring)

Thanks to:

- the many contributors who reviewed and participated in brainstorming,
Expand Down
80 changes: 80 additions & 0 deletions mentoring/mentors/group-mentoring.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,80 @@
# Contributor Ladder Growth Programs

These programs place an emphasis on learning in groups for active contributors
that would like to be a reviewer or other leadership roles like a Chair. The
groups are semi-structured learning environments over the course of three
months or a release cycle. Want to get `/lgtm` rights? Be a decision maker in an
OWNERS file? This could be a great way to get the knowledge you need, and some
accountability to do it. Through this program you will get the opportunity to
interact with active contributors who may be on the same path as you as well
very experienced Kubernetes contributors.

## How This Works
Foundation:
This program is built around our [community membership guidelines] as well as
our [Chair] and [Tech Lead] governance descriptions.
These docs show how you can grow through the project in different roles and
provides the requirements to get to each level on our ladder. Building trust is
key.

## Cohorts
- No more than 4 mentees per 1 mentor; no more than 8 total in the group
- this scales better than 1:1 and peers can help each other in a community
setting
- Everyone is on the same journey
Member -> Reviewer | Reviewer -> Approver | SIG Member -> Chair
- Three months / one release cycle
- Private slack channel
For you to progress, the community wants to know you are dependable and
understand the domain.

Mentors can rotate facilitating once a week for slack standups with the
expectation that cohort members need to check in with a predetermined status
update (accomplishments, challenges, etc)

## Benefits of a Cohort
* Peer mentoring
* Clear goals, objectives, and timelines
* Each mentee is working toward the same goal, cohort has an end date/timeframe
* Exposure to multiple areas of the project making well-rounded contributors
* Mentors share time commitments and responsibilities
* Exposure to multiple mentors in an open and collaborative environment


## Mentor requirements
- Github Org Member
- At least the same level as the goal of the group (example: Reviewer for
Reviewers)
- Time commitment: facilitate biweekly, hour long zoom sessions plus curriculum
planning in between sessions (~1-2h/wk total).

## First Cohort Success Rates
5/10 graduated into OWNERs files from members to reviewers in 2019. 2 are
subproject owners in 2021.

## FAQs
I'm a SIG Chair/TL/Subproject Owner and have a need for more members, reviewers,
approvers, how can we form a cohort?
Reach out to #sig-contribex in slack or file an issue against
kubernetes/community

I'm a contributor looking for a cohort, where do I go?
Look in the kubernetes/community repo for issues labelled "contributor ladder
mentoring"

I'm not a chair, tech lead, or subproject owner but I'm a reviewer or approver,
how can I help?
Talk to your Chairs and Tech Leads about forming a group that you can help
mentor.


## Important Links
[Mentor Guide]
[Mentee Guide]

[Mentee Guide]: /mentoring/programs/archive/group-mentee-guide.mdguide.md
[Mentoring/Contributor Info Form]: https://goo.gl/forms/SHWAiZ9Ih1qwuJbs1
[Mentor Guide]: /mentoring/mentors/mentor-guide.md
[community membership guidelines]: /community-membership.md
[Chair]: https://github.com/kubernetes/community/blob/master/committee-steering/governance/sig-governance.md#chair
[Tech Lead]: https://github.com/kubernetes/community/blob/master/contributors/chairs-and-techleads/technical-lead.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ There are many ways you can be a mentor within the Kubernetes ecosystem. Listeni

You are serving two roles - coach and advisor. You are a problem solver that doesn’t have all of the answers but will know the best resources to go to get the guidance that is needed. You are helping to create a culture of continuous improvement, collaboration, and feedback.

Check out our [mentoring programs](README.md) for more detailed descriptions. Please use [this form](https://goo.gl/forms/Y4MH6NGHe6OU5cZC3) to sign up to mentor.
Check out our [mentoring programs](../processes/README.md) for more detailed descriptions. Please use [this form](https://goo.gl/forms/Y4MH6NGHe6OU5cZC3) to sign up to mentor.

## Responsibilities and Expectations
*for ALL programs*
Expand All @@ -34,7 +34,7 @@ Check out our [mentoring programs](README.md) for more detailed descriptions. Pl
* Only new contributors need mentoring.

### Responsibilities by each program
*[Group mentoring](group-mentoring.md)*
*[Group mentoring](../processes/group-mentoring.md)*

You’ll need to be:
* On Slack at least 1-2 hours a week fielding questions.
Expand Down
2 changes: 1 addition & 1 deletion mentoring/processes/group-mentoring.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ suggestions:
*Chair/TL combo*
Chair + Reviewer
- All of the above
- [Sample curriculum](../programs/leads-curriculum.md)
- [Sample curriculum](leads-curriculum.md)

One of the best strategies is to have everyone work on something together,
Examples:
Expand Down
31 changes: 31 additions & 0 deletions mentoring/programs/2024/groupmentorship/group-mentor-planning.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
# 2024 Group Cohort Mentorship September - November

Status: Planning

Mentorship duration - TBD

## Timeline

| activity | date | status |
|--------------------------------------------------------------------------------|----------|-------------|
| Plan time-line | Aug 24 | In progress |
| Recruit contribex help (at least 3 ) | Aug 30 | |
| Communication to SIGs - identify learning type (approvers, tech leads, chairs) | Aug 30 | |
| Create Sylabus/Curriculum | Sep 6 | |
| Identify Mentor roles/Cadence | Sept 13 | |
| Create private slack chanels/mailing lists/meetings | Sep 6 | |
| Open Program | Sep 13 | |
| Program start | Sep 18 | |
| Program end | | |
| Feedback | | |

## ContribEx Roles
- Program Coordinator
- Handle logistics
- set up meetings
- communications
- Mentor/Mentee Support
- slack chanel moderator
- Program Support x 2
- Host meetings and events
- upport the Coordinator
66 changes: 66 additions & 0 deletions mentoring/programs/archive/README-Meetings.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
---
title: "Mentoring Programs and Resources"
weight: 3
description: |
An index of Kubernetes Mentoring programs, initiatives, and resources.
---

# Kubernetes Upstream Mentoring Programs

This page indexes all of the mentoring initiatives for contributing to the Kubernetes project. For end user mentoring initiatives, check out KubeCon and other CNCF events and programs.

---

We understand that everyone has different learning styles and we want to support
as many of those as possible. Mentoring is vital to the growth of an individual
and organization of every kind. For Kubernetes, the larger the project becomes
, it's necessary to keep a continuous pipeline of quality contributors and we want you to hang around!

## Current mentoring activities:

Please reach out to #sig-contribex on slack or come to a mentoring meeting to get involved in planning //TODO add contribex README when this is updated

Long Term Contributor Ladder Growth

- Through [Group Mentoring Cohorts](/mentoring/programs/archive/group-mentoring.md)

Specific topics and activities

- [The 1:1 Hour](/mentoring/programs/archive/the1-on-1hour.md)

Role based shadow programs

- [List of programs](/mentoring/programs/2024/shadow-roles.md)

Students

- [Google Summer of Code](/mentoring/programs/archive/google-summer-of-code.md)


Groups Traditionally Underrepresented in Tech

- [Outreachy](/mentoring/programs/archive/outreachy.md)

In person

- [Videos of New Contributor Workshop](https://www.youtube.com/playlist?list=PL69nYSiGNLP3M5X7stuD7N4r3uP2PZQUx)
- Pod Mentoring! [aka group mentoring](/mentoring/programs/mentoring-events.md)

#### Inspiration and Thanks

This is not an out of the box program but was largely inspired by the following:

- [Ada Developer Academy](https://adadevelopersacademy.org/)
- [Apache Mentoring Programme](https://community.apache.org/mentoringprogramme.html)
- [exercism.io](https://github.com/OperationCode/exercism-io-mentoring)
- [Google Summer of Code](https://developers.google.com/open-source/gsoc/)
- [Outreachy](https://www.outreachy.org/)
- [OpenStack Mentoring](https://wiki.openstack.org/wiki/Mentoring)

Thanks to:

- the many contributors who reviewed and participated in brainstorming,
- founding mentees for their willingness to try this out,
- founding mentors (@chrislovecnm, @luxas, @kow3ns, @nikhita)

We welcome PRs, suggestions, and help!
Loading