proposal: deprecate always_run in favor of checkmode_run
This commit is contained in:
parent
9acb5aa176
commit
26005dfa5b
1 changed files with 34 additions and 0 deletions
34
docs/proposals/rename_always_run.md
Normal file
34
docs/proposals/rename_always_run.md
Normal file
|
@ -0,0 +1,34 @@
|
|||
# Rename always_run to checkmode_run
|
||||
|
||||
*Author*: René Moser <@resmo>
|
||||
|
||||
*Date*: 02/03/2016
|
||||
|
||||
## Motivation
|
||||
|
||||
The task argument `always_run` is misleading.
|
||||
|
||||
Ansible is known to be readable by users without deep knowledge of creating playbooks, they do not understand
|
||||
what `always_run` does at the first glance.
|
||||
|
||||
### Problems
|
||||
|
||||
The following looks scary if you have no idea, what `always_run` does:
|
||||
|
||||
```
|
||||
- shell: dangerous_cleanup.sh
|
||||
when: cleanup == "yes"
|
||||
always_run: yes
|
||||
```
|
||||
|
||||
You have a conditional but also a word that says `always`. This is a conflict in terms of understanding.
|
||||
|
||||
## Solution Proposal
|
||||
|
||||
Deprecate `always_run` by rename it to `checkmode_run`:
|
||||
|
||||
```
|
||||
- shell: dangerous_cleanup.sh
|
||||
when: cleanup == "yes"
|
||||
checkmode_run: yes
|
||||
```
|
Loading…
Reference in a new issue