blob: 05e7172c8d9d941546019f983609fae074696323 [file] [log] [blame] [view]
Jaana B. Dogana302fdd2017-01-15 18:30:29 -08001# Developer Experience Working Group (draft)
Jaana Burcu Dogana950c052017-01-11 09:32:17 -08002
Jaana Burcu Doganc34226e2017-01-12 10:39:21 -08003Developer Experience Working Group is a team trying to make the Go programming language, libraries and tools more pleasant to use. The team primarily works on the Go project, even though its responsibilities and activities may involve contributing to the ecosystem-wide impactful projects. The group is aimed to cover a highly specialized field of expertise that is not always well-covered by the core team.
Jaana Burcu Dogan6d1048f2017-01-10 17:24:19 -08004
Jaana Burcu Dogana950c052017-01-11 09:32:17 -08005## Goals
Jaana Burcu Dogan6d1048f2017-01-10 17:24:19 -08006
Jaana Burcu Dogan28bb2a92017-01-11 11:21:05 -08007* Making Go a preferred language in industry and education.
8* Helping the language graduate to a mainstream language by enabling the early majority developers.
Jaana B. Doganba1f7112017-02-01 23:39:14 -08009* Helping Go to succeed in organizations with opinionated infrastructure and tooling.
Jaana Burcu Dogancc479642017-01-11 09:40:07 -080010
Jaana B. Dogan7dec6232017-05-22 11:12:52 -070011## Projects
12Ongoing projects, feel free to reach out to the project lead if you want to collaborate:
Jaana Burcu Dogan3c980222017-01-10 17:31:41 -080013
Jaana B. Dogan7dec6232017-05-22 11:12:52 -070014- Improvements to the Go installation experience (Chris Broadfoot <cbro@golang.org>)
15- Guides on tooling and developer environments (editors and IDEs) (Jaana B. Dogan <jbd@golang.org>)
16- Running user studies to systematically analyze and measure friction points (Chris Broadfoot <cbro@golang.org>, Katrina Owen <katrina.owen@gmail.com>, Steve Francia <sfrancia@google.com>)
17- Improvements to the Go Tour and Go Playground (Chris Broadfoot <cbro@golang.org>, Steve Francia <sfrancia@google.com>)
18- Better guidelines to help new users and visual aids for golang.org (Jaana B. Dogan <jbd@golang.org>)
Jaana Burcu Dogande32b4c2017-01-12 10:43:53 -080019
Jaana Burcu Dogan4e16e8e2017-01-11 11:54:37 -080020## Channels
Jaana B. Dogan7dec6232017-05-22 11:12:52 -070021* Mailing list: [golang-devexp](https://groups.google.com/forum/#!forum/golang-devexp)
22* Gophers Slack channel if you need synchronous help: [#devexp](https://gophers.slack.com/archives/devexp) ([invitation](https://invite.slack.golangbridge.org/))
Jaana Burcu Dogan4e16e8e2017-01-11 11:54:37 -080023
Jaana Burcu Dogana950c052017-01-11 09:32:17 -080024## Responsibilities and Activities
Jaana Burcu Dogan6d1048f2017-01-10 17:24:19 -080025* Identify the barriers for newcomers and remove them to make Go succeed as a mainstream programming language.
Jaana Burcu Dogane372aca2017-01-10 17:27:16 -080026Revamp the existing docs and tools.
Jaana Burcu Dogan0ec7e7e2017-01-12 10:51:31 -080027* Systematically collect feedback from the Go users to improve friction points in standard library, tools, docs, language and the ecosystem. The group may also run UX studies.
Jaana Burcu Dogan0be3ad22017-01-12 10:41:36 -080028* Help identifying the critical missing libraries/tools from the ecosystem.
29* At each release cycle, review new standard library APIs to give feedback about usability, self-explanation and documentation.
Jaana Burcu Dogan6d1048f2017-01-10 17:24:19 -080030* Participate in user-facing Go proposals to give usability feedback.
Jaana Burcu Dogan6d1048f2017-01-10 17:24:19 -080031* Encourage readable and idiomatic APIs. Be the voice of best practices in API design.
32* Contribute with technical writing on the Go blog to fill the gaps in communication.
Jaana Burcu Dogan92259352017-01-11 13:31:32 -080033
34## Roles
35
Jaana Burcu Dogan1d4248f2017-01-11 15:21:30 -080036The group has a variety of roles with specific responsibilities. Although it is not a hard requirement, all contributors are expected to have background and technical expertise in one or more of these fields: API design, developer tooling, readability, programming language design and education, and technical writing.
Jaana Burcu Dogan92259352017-01-11 13:31:32 -080037
38### Leads
Jaana B. Dogan740674a2017-02-07 14:27:41 -080039We are expecting this role to require 15 hours of commitment each week.
Jaana Burcu Dogane18e15c2017-01-12 10:48:58 -080040* All responsibilities of the members
Jaana Burcu Dogana980f812017-01-12 10:35:04 -080041* Ensuring contributors are sufficiently productive and not blocked
Jaana Burcu Dogan92259352017-01-11 13:31:32 -080042* Reaching consensus if there is no obvious answer
Jaana Burcu Dogan8730fd12017-01-11 13:34:28 -080043* Organizing meetings and handling paperwork
Jaana Burcu Dogan92259352017-01-11 13:31:32 -080044
45### Members
Jaana Burcu Dogana6e9e842017-01-13 09:35:00 -080046We are expecting this role to require 10 hours of commitment each week.
Jaana Burcu Dogane18e15c2017-01-12 10:48:58 -080047* All responsibilities of the participants
Jaana Burcu Dogan92259352017-01-11 13:31:32 -080048* Doing the first CL and proposal reviews
Jaana Burcu Dogan5c408f02017-01-11 13:32:48 -080049* Setting high-level goals and establishing long-term milestones
Jaana Burcu Dogan963020c2017-01-11 15:11:15 -080050* Mentor community about best practices
Jaana Burcu Dogan92259352017-01-11 13:31:32 -080051
52### Participants
Jaana Burcu Dogan5c408f02017-01-11 13:32:48 -080053Participants don't have to commit to any long-term plans, they work as much as they want on gradual improvements and contribute to the discussion.
Jaana Burcu Dogan92259352017-01-11 13:31:32 -080054* Creating CLs and proposals
Jaana Burcu Dogan5c408f02017-01-11 13:32:48 -080055* Participating in discussions