lot's of standardizing with the refacto

meta/argument_spec.yml

@@ -1,43 +1,40 @@
 ---
 argument_specs:
   main:
-    short_description: install software easily
+    short_description: Install software using ansible
     description:
       - Make the installation of packages consistent on each platform.
-      - Installs for RedHat, Debian or Darwin based systems.
+      - Installs for RedHat, Debian and MacOS based systems.
     author:
       - Matthew Stobbs <matthew@stobbs.ca>
     options:
+      use_local:
+        type: bool
+        default: true
+        required: false
+        description:
+            Install packages using the current users
+            `$HOME/.local` directory as the install prefix.
+
+            WHen `false`, uses the system wide `/usr/local`
+            as the install prefix, and stores other parts
+            (appimages, extracted archives, cache) in the
+            appropriate path starting with `/opt`.
       packages:
-        type: "list"
-        elements: "str"
+        type: list
+        elements: str
         required: true
         description: |
             The list of packages to install by name.
-      syspkglist:
-        type: "list"
-        elements: "str"
+            The list must contain only values that exist in
+            `Available Packages` in `README.md`
+      prefer_method:
+        type: str
         required: false
-        description: |
-            Additional packages to install via the system
-            default package manager. Is combined with the
-            completed list of packages to install.
-            Only use this if you a package isn't available to the role.
-      install_state:
-        type: "str"
+        default: system
         choices:
-          - "present"
-          - "latest"
-          - "absent"
-        required: false
-        default: present
-        description: |
-            Desired state of the packages to install.
-      full_upgrade:
-        type: "bool"
-        required: false
-        default: false
-        description: |
-            Do a full system upgrade before installing
-            additional packages. This does not handle
-            rebooting a machine that has been upgraded.
+          - flatpak
+          - langtool
+          - snap
+          - source
+          - system