updating documentation

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

README.md

@@ -1,4 +1,5 @@
-# ansible_role_package
+# Ansible package manager
+## _A ports like system for ansible_
 
 Manage package installation for a number of packages
 that sometimes need special handling. Some are built from
@@ -10,14 +11,16 @@ special instructions to properly install and use. I decided to
 simplify the management of those packages by creating a role with
 special handling.
 
+_The following are for general use. Not all packages have a candidate for system package managers_
+
 Order of precedence for package installation:
 
 1. System package manager (dnf, apt, homebrew, etc.)
 2. Source built - only in some situations, like for fast moving software (neovim, hyprland)
-3. Appimage (Linux only)
-4. Flatpak (Linux only)
-5. Snap (Linux only), takes precedence over flatpak on Ubuntu based systems
-6. Language package manager (`cargo install`, `go install`, `npm install`, etc.)
+    - Includes language package managers like `go install`, `cargo install`, and `npm install`
+3. Flatpak (Linux only)
+4. Snap (Linux only)
+5. Appimage (Linux only)
 
 _This does not configure installed software, just installs it_
 
@@ -26,11 +29,11 @@ To install any of the available packages, they must be part of a list called
 
 ## Supported Operating Systems
 
-- Fedora Linux
-- MacOS
-- RHEL based distributions *Experimental* *best effort*
-- Debian *Experimental*
-- Alpine linux *Experimental* *best effort)
+- Fedora Linux _first class support_
+- MacOS _best effort_
+- RHEL based distributions _Experimental, best effort_
+- Debian _Experimental, best effort_
+- Alpine linux _Experimental, best effort_
 
 ## Available Packages