Skip to content

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

@joshuabezaleel

Description

@joshuabezaleel

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    kind/initiativeAn initiative or an item related to imitative processesneeds-triageIndicates an issue or PR that has not been triaged yet (has a 'triage/foo' label applied)tag/developer-experienceTAG Developer Experience

    Type

    No type
    No fields configured for issues without a type.

    Projects

    Status

    New

    Status

    status/new

    Status

    No status

    Status

    No status

    Status

    No status

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions