Explorar el Código

Make decisions

Users expect role authors to make decisions.  The role author is
supposed to be the expert who knows what choices to make on behalf of
the user.
Mike Ashley hace 9 años
padre
commit
fc28baf6b8
Se han modificado 1 ficheros con 4 adiciones y 0 borrados
  1. 4
    0
      CONTRIBUTING.md

+ 4
- 0
CONTRIBUTING.md Ver fichero

14
 
14
 
15
 Sovereign is an Ansible playbook that uses the modules in this repository to configure a server. Modules should conform to the following design principles.
15
 Sovereign is an Ansible playbook that uses the modules in this repository to configure a server. Modules should conform to the following design principles.
16
 
16
 
17
+### Making decisions
18
+
19
+A module exists to make decisions about how a service should be installed and configured. Make these decisions and minimize or eliminate configuration options exposed to the user. When in doubt, make a decision, and if the community feedback is vocal enough, only then expose an option.
20
+
17
 ### Idempotency
21
 ### Idempotency
18
 
22
 
19
 A module must be idempotent. If it's run once or many times, the result should be the same. This means that in some cases the user will be left with post-installation finalization work to do. Post-install finalization should be reduced or eliminated if possible, but not at the cost of idempotency.
23
 A module must be idempotent. If it's run once or many times, the result should be the same. This means that in some cases the user will be left with post-installation finalization work to do. Post-install finalization should be reduced or eliminated if possible, but not at the cost of idempotency.

Loading…
Cancelar
Guardar