owned this note
owned this note
Published
Linked with GitHub
# User Stories for Community Docs
## Possible personas
- As an **Ansible community member**, I want to become more involved in the community (discussions, bug reporting, feature enhancements etc) and share my knowledge with other Ansible community members.
- As an **Ansible contributor**, I want to help fix bugs, contribute to core/collections, help test, etc
- As an **Ansible content creator,** I want to use Ansible to create new playbooks, roles, execution environments (aka I am not comfortable coding in python)
- As an **Ansible content developer**, I want to create new modules/plugins or collections or enhance existing ones (aka I can code in python)
(draft below- just pulled from current community docs)
## Community members
### New
- Where can I talk to other Ansible users, ask questions etc (meetups, IRC, email, reddit, etc)
- Where to learn more about Ansible (books, tutorials, certifications, events, docs to read, videos from Fest etc)
- Where can I learn what's new or expected in an upcoming Ansible release?
### Experienced
- how can I host a meetup? share my knowlege in blogs, present at AnsibleFest, etc
## Contributors
### New
- what are the requirements for a new contributor?( Code of Conduct, Contributors license agreement, etc)
- Easy ways to contribute? ( fixing docs bugs, etc)
- How do I report a bug?
- How do I request a feature?
- How can I get involved in a working group and/or start a new one for my area of expertise?
- How do I review GitHub issues and pull requests?
- My pull request is marked needs_rebase. How do I rebase my PR?
- How do I backport a bugfix PR?
### Experienced
- How do I get involved in feature enhancement decisions and overall direction of Ansible?
## Content creators
- How do I create playbooks? Roles?
- How can I test my playbooks, roles?
- How do I share my roles with others in the community?
- How do I create my own execution environments?
## Content developers
### Developing code
(*this gets close to being more developer focused than community contributor general docs...*)
- How do I set up my Python development environment? What other tools should I use (linters etc)
- What are the code requirements for core? for collections?
- what is the development cycle?
- How do I learn more about tests and CI?
### Contributing code to collections
- How do I contribute to a community vs Ansible-maintained collection?
- How do I create a collection? How do I get it in Ansible the package? How about get it certified?
- How do I become a collection maintainer?
- How do I deprecate a module?