improved comments

Author: PascalKont

aliases/ansible-dev.aliases.bash

@@ -1,10 +1,10 @@
 #! bash oh-my-bash.module
 
-# used to be functions in previous ansible oh-my-bash plugin
+# kept for backwards compatbility, these used to be functions in the previous oh-my-bash ansible plugin
 alias ansible-role-init='ansible-galaxy init role '
 alias arinit='ansible-role-init'
 
-# ansible-dev-tools
+# ansible-dev-tools: https://docs.ansible.com/projects/dev-tools/
 alias abu='ansible-builder ' # did not want to use 'ab', as it is an existing command for Apache benchmarking tool
 alias abb='ansible-builder build '
 alias abc='ansible-builder create '
@@ -18,6 +18,6 @@ alias alint='ansible-lint '
 alias anav='ansible-navigator '
 alias arunner='ansible-runner '
 alias arun='ansible-runner run '
-alias astart='ansible-runner start'
-alias astop='ansible-runner stop'
+alias astart='ansible-runner start '
+alias astop='ansible-runner stop '
 alias asign='ansible-sign '

aliases/ansible.aliases.bash

@@ -1,18 +1,18 @@
 #! bash oh-my-bash.module
 
-# used to be functions in previous ansible oh-my-bash plugin
+# kept for backwards compatbility, these used to be functions in the previous oh-my-bash ansible plugin
 alias aver='ansible --version; ansible-community --version'
 #alias arinit='ansible-role-init'   # this alias can now be found in the ansible-dev aliases
 
-# ansible-core
+# ansible-core: https://docs.ansible.com/projects/ansible-core/devel/
 alias a='ansible '
 alias aconf='ansible-config '
 alias acon='ansible-console '
 alias adoc='ansible-doc '
 alias agal='ansible-galaxy '
 alias ainv='ansible-inventory '
 alias aplay='ansible-playbook '
-alias aplaybook='aplay' # long version kept for backward compatibility
+alias aplaybook='aplay' # this long version of the playbook alias is kept for backwards compatibility
 alias apull='ansible-pull '
 alias atest='ansible-test '
 alias aval='ansible-vault '

aliases/molecule.aliases.bash

@@ -1,5 +1,6 @@
 #! bash oh-my-bash.module
 
+# molecule: https://docs.ansible.com/projects/molecule/
 alias mol='molecule '
 alias mhlp='molecule --help '
 alias mchk='molecule check '