-
Notifications
You must be signed in to change notification settings - Fork 144
Contributor Experience: Plan
Topics
- Theme 1: Build up working groups
- Theme 2: How to develop modules
- Theme 3: PR(/issue) backlog
- Timeline
The Contributor Experience had a wide remit, though is currently focusing on the following:
- Theme 1: Build up Working Groups
- Theme 2: Make it clearer how to develop modules
- Theme 3: Reduce issue/PR backlog
Discussion welcome in #ansible-community
or in Contributor Experience Etherpad
Objective: This is about scale and empowering others to do things themselves
A well functioning group should be able to:
- Welcome new members into the group
- Provide a variety of items (not just coding) for people to get involved with
- Keep on top of their backlog
- Set direction
Goal: Find out if we are building up and maintaining active groups.
aka If we don't measure, how do we know if we are improving
Interested in participation not just people idling
- Unique people active in IRC meetings
- Number of people active on agenda issues
- How do people find out about the groups
- Why do people stay
- Why do people leave
Goal: Make life easier
- Asking a wider range of people for pain points allows us to spot common issues and address them
- Review previous Contributor Summit docs
- Important to get input from new contributors
The various groups have found things that work for them, we should review, document and roll out for other groups what works. If something doesn't work then analyse why not
- AWS: Monthly status
- Simple to do
- Shows progress
- Motivates
- Network: track actions on agenda
- Network First Gamification Exercise - Earn Ansible Swag!
Goal: Showing progress keeps motivation
- Motivates existing and new people
- Such as AWS's boto3 porting and testing monthly stats
Goal: Ensure that new people that want to get involved have something to help with
- MUST include non-Python tasks
- MUST include some well defined simple items
On hold till till above items have been done, we don't want to invite more people till the groups are in a better state
-
Ansibullbot to promote IRC Working groups #820DONE - Standard slide and promotion to include in Meetups
On hold till till above items have been done
Series of blog posts, one per working group, showing what they've achieved and how to get involved.
Objective:
- Docs: dev_guide reorg to make it easier to create and write content (acozine is working on this)
- Docs: Real examples on how to document your module
- Docs: fix module checklist
- Docs: How to write a good integration tests
- Continue to spot common issues with new PRs and doc/automatically test them
(Will partly be addressed by Theme 1)
Where ever modules live (ansible/(ansible, modules-core, ...) there will always be issues and PRs raised. Understanding how the backlog builds up and empowering people to reduce it is key.
- Break PR workflow into a flowchart, stats on where on the workflow PRs are
- Attack these areas as individual items
Thanks to Ansibullbot we know if a PR is from a new_contributor
Analyzing new_contributor
's gives us a good insight into how clear our docs, process and tests are. This is important as we often get sidetracked by regular contributors that have been through these issues before and overcome.
- New contributors that receive feedback on their first PR sooner are more likely to contribute again Mozilla research
- CI Issues
- Are issues found valid
- Are the error messages obvious
- GitHub Checks API should help this - Waiting on Shippable and Zuul
- Spot trends, do RCA, fix at source
Via BOTMETA and a Module's author:
we have a reasonable idea of who to notify when an Issue or PR.
Before we add more maintainers we need to ensure that the existing process is work, ie that "pings" are being responded to.
- docsite_pr links
- 2018-07-23 Theme 1: Ansibullbot to promote IRC Working groups #820
- 2018-08-22 Theme 3: Simplify issue templates
This Wiki is used for quick notes, not for support or documentation.
Working groups are now in the Ansible forum
Ansible project:
Community,
Contributor Experience,
Docs,
News,
Outreach,
RelEng,
Testing
Cloud:
AWS,
Azure,
CloudStack,
Container,
DigitalOcean,
Docker,
hcloud,
Kubernetes,
Linode,
OpenStack,
oVirt,
Virt,
VMware
Networking:
ACI,
AVI,
F5,
Meraki,
Network,
NXOS
Ansible Developer Tools:
Ansible-developer-tools
Software:
Crypto,
Foreman,
GDrive,
GitLab,
Grafana,
IPA,
JBoss,
MongoDB,
MySQL,
PostgreSQL,
RabbitMQ,
Zabbix
System:
AIX,
BSD,
HP-UX,
macOS,
Remote Management,
Solaris,
Windows
Security:
Security-Automation,
Lockdown
Tooling:
AWX,
Galaxy,
Molecule
Plugins:
httpapi