updating documentation

- giving things a better structure
- better documentation with the way things need to be as a standard

tasks/pkgs/air.yml

@@ -1,8 +1,14 @@
 # vim: set filetype=yaml.ansible :
+# Package: air
+# Description: application auto reload for go
+# Version: latest
+# Methods: source (go install)
+# Helpers: go_install
 ---
-- name: Configure air # {{{
+# {{{ Configure air
+- name: Start air configuration
   when:
-    - __air_configured is undefined
+    - "'air' not in __configured"
   block:
     - name: Set air install method
       when:
@@ -44,6 +50,6 @@
           ansible.builtin.set_fact:
             pkg_go: "{{ pkg_go + [air_go_pkg] }}"
 
-    - name: Complete air configuration
+    - name: Finalize air configuration
       ansible.builtin.set_fact:
-        __air_configured: true
+        __configured: "{{ __configured | combine( { 'air': true } ) }}"

tasks/pkgs/ansible.yml

@@ -1,9 +1,5 @@
 # vim: set filetype=yaml.ansible :
 ---
-- name: Set maintainer
-  ansible.builtin.set_fact:
-    ansible_maintainers:
-      - Matthew Stobbs
 - name: Configure ansible
   when:
     - __ansible_configured is undefined or

tasks/pkgs/ansible_ls.yml

@@ -1,6 +1,6 @@
 # vim: set filetype=yaml.ansible :
 ---
-- name: Add ansible_ls
+- name: Configure ansible_ls
   when:
     - __ansible_ls_configured is undefined
   block:
@@ -10,9 +10,19 @@
       ansible.builtin.set_fact:
         ansible_ls_install_method: "{% if install_method in ansible_ls_install_methods %}{{ install_method }}{% else %}{{ ansible_ls_install_methods[0] }}{% endif %}"
 
-    - name: Append ansible-language-server to pkg_npm
+    - name: Configure ansible_ls source npm installation
+      when:
+        - ansible_ls_install_method == 'source'
       ansible.builtin.set_fact:
-        pkg_npm: "{{ pkg_npm + ['@ansible/ansible-language-server'] }}"
+        ansible_npm_pkg:
+          name: '@ansible/ansible-language-server'
+          global: true
+
+    - name: Append ansible-language-server to pkg_npm
+      when:
+        - ansible_ls_install_method == 'source'
+      ansible.builtin.set_fact:
+        pkg_npm: "{{ pkg_npm + [ansible_npm_pkg] }}"
 
     - name: Set ansible_ls_configured
       when:

tasks/pkgs/go.yml

@@ -56,11 +56,11 @@
         - name: Finalize go archive install
           ansible.builtin.set_fact:
             go_archive_install:
-              extract_path: "{{ go_extract_path }}"
-              archive_url: "{{ go_archive_url }}"
-              archive_name: "{{ go_archive }}"
-              archive_checksum: "{{ go_archive_sums[go_archive_version][ansible_system][go_arch] }}"
-              link_bin:
+              extract_to: "{{ go_extract_path }}"
+              url: "{{ go_archive_url }}"
+              name: "{{ go_archive }}"
+              checksum: "{{ go_archive_sums[go_archive_version][ansible_system][go_arch] }}"
+              bins:
                 - from: "{{ go_archive_path }}/go"
                   to: "{{ path_go }}"
                   force: true