Skip to content
This repository has been archived by the owner on Jun 10, 2024. It is now read-only.

Checklist

Dag Wieers edited this page Feb 15, 2019 · 9 revisions

[ Roles | Communication | Reviewing | Checklist | TODO ]

Self-assessment checklist (draft)

A Working Group has many fronts to cover and some of them are more important than others. Below we have a list of things any Working Group can evaluate to see how they score compared to others, and what they could be working on.

Module status

  • Does every module have an integration test that covers all aspects of the module ?
    • Even when the module cannot be automatically tested, having integration tests helps the WG to evaluate changes.
    • Does it cover idempotency and check-mode ?
    • Does it test error-conditions ?
    • Does it test special conditions or optional logic (e.g. backup) ?
  • Do you have a module_utils library that shares codes between modules ?
    • Does it have an argument_spec definition that shares common module parameters ?
  • Does check-mode actually cover all changes made, or is it just a stub exit-function at the top ?
    • Does check-mode behaves as closely as possible to a real run ?
    • Does it also return information as if it was run ? (Not always possible...)
  • Are any of your modules listed to ignore certain tests (because they fail) ?

Backlog

  • Is your issue backlog under control ?
    • Do all issues have recent activity ?
  • Is your PR backlog under control ?
    • Do all PRs have recent activity ?

Documentation

  • Do you have a doc_fragments section so that the common documentation is shared between modules ?
    • Does your doc_fragments include a notes: or seealso: section for all modules ?
  • Does your module documentation have references to other documentation ?
    • Does it include seealso: references to other modules ?
    • Does it include seealso: references to other Internet documentation ?
  • Does your module documentation include type information for every parameter ?
  • Does your Working Group have a guide in the official Ansible documentation on how to use your modules ?
    • Including best practices and tips-and-tricks ?

(ARchived) Working groups

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

Communities

Modules:
unarchive, xml

Plugins:
httpapi

Wiki

Roles, Communication, Reviewing, Checklist, TODO

Clone this wiki locally