cncf / cncf/toc

[Initiative]: Developer Experience Improvement and Shared Practices of CNCF Projects

Open
#2,055 14 comments 1 reaction 0 assignees View on GitHub
kind/initiative needs-triage tag/developer-experience
Dominant language
HTML
Stars
1.9k
Forks
724
Avg merge
6d 12h
Merged PRs (30d)
4

Description

### Name

Developer Experience Improvement and Shared Practices of CNCF Projects

### Short description

This initiative aims to establish collaboration in improving Developer Experience across CNCF projects through shared practices and institutional knowledge

### Responsible group

TAG Developer Experience

### Does the initiative belong to a subproject?

No

### Subproject name

_No response_

### Primary contact

Joshua Bezaleel Abednego (gh: @joshuabezaleel | email: joshua.bezaleel@gmail.com)

### Additional contacts

_No response_

### Initiative description

CNCF hosts hundreds of projects across different maturity levels, touching the workflows of countless developers daily. Even within the same project different developers might encounter different experiences. Some developers find their path smooth, others might encounter friction, and maintainers must balance developer experience against core functionality priorities and limited resources. More mature projects like Prometheus established a UX research working group and Kubernetes previously maintained SIG Usability to address the said problem, but newer projects seeking to progress toward maturity often start from scratch in their journey to understand and serve developer needs. While individual projects may pursue their own Developer Experience improvement journeys, the ecosystem would benefit from collaborative approaches that build upon shared practices and address overlapping challenges across projects.

This initiative aims to establish a collaborative effort for assessing and strengthening developer experience of CNCF projects. It creates shared resources, tools, and community of practice that projects can adopt progressively based on their maturity and capacity. By capturing institutional knowledge from projects that have made their effort in enhancing Developer Experience, establishing a baseline or practices that can be adopted, and creating pathways for non-code contributors, this initiative gives CNCF projects foundation to build improvement on the developer experience practices over time.

### Deliverable(s) or exit criteria

### Goals
**Create a Shared DX Knowledge Base**: Capture and synthesize DX practices, research findings, and lessons learned from CNCF projects, transforming existing efforts into reusable patterns and anti-patterns that benefit the ecosystem, particularly projects without dedicated DX resources.

**Enable Systematic DX Contribution Pathways**: Establish frameworks and resources that allow UX researchers, technical writers, and DX practitioners to contribute meaningfully to CNCF projects. This is planning to address the current gap where these contributors want to help but lack structured entry points.

**Establish DX Benchmark for Cloud Native Projects**: Define a set of DX qualities that CNCF projects can use as reference for improvement. Provide assessment criteria and measurement approaches that projects can self-evaluate against.

### Deliverables
**DX Landscape Report**: Conduct interviews with 3-5 mature CNCF projects to document their DX initiatives, research methodologies, pain points addressed, and organizational approaches. Synthesize findings into a public report identifying common patterns, gaps, and opportunities.

**Initial DX Assessment Framework**: Develop a lightweight, self-service assessment tool set of DX qualities, focusing on 3-4 high-impact dimensions that most projects can evaluate without specialized expertise (e.g., documentation quality, community feedback mechanisms, etc.).

**DX Community Group**: Establish a community group as a place for project maintainers, practitioners, and others who are interested in Developer Experience especially in the context for CNCF projects. Hold syncs to review assessments, share practices, and develop shared resources. Create a public Slack channel and meeting recordings.

**CNCF DX Playbook**: A living document synthesizing insights from mature projects' DX initiatives including case studies, proven patterns, anti-patterns to avoid, and guidance on establishing process e.g. user research program, survey, friction log, etc. Provides progressive guidance as to tailor for every project maturity.

**Project Lifecycle Integration Proposal**: Proposal to integrate DX criterias with current CNCF project lifecycle e.g. technical review and due diligence to ensure DX improvement and qualities are being met according to each level.

### Tracking document for meeting and progress

https://notes.cncf.io/s/Oc6SdsBFz

Contributor guide

Open the contributing guide

Research direction

Start with the linked CNCF tracking document and review the initiative goals and deliverables. Map the proposed DX landscape report, assessment framework, community group, playbook, and lifecycle integration proposal to concrete owners and milestones. Done means the agreed deliverables are produced and the collaboration pathways are established.

Written by the indexing model from the issue text.

Assessment

Domain
developer-experience, documentation, tooling
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.