chore: Documentation and minor tweaks

Author: hyperupcall

.editorconfig

@@ -1,3 +1,5 @@
+root = true
+
 [*]
 indent_style = tab
 indent_size = 4

.gitattributes

@@ -1,2 +1,2 @@
 * text=auto
-.glue linguist-generated
+.glue/ linguist-generated

.gitignore

@@ -1,8 +1 @@
-package/aur/**
-package/deb/**
-package/rpm/**
-!package/*/run.sh
-!package/*/toast.yml
-!package/*/PKGBUILD
-!package/*/*.spec
-.glue/
+.basalt/

docs/reference.md

@@ -11,7 +11,7 @@ An array that contains every argument or flag after the first `--`
 ```sh
 declare -a argsPostHyphen=()
 
-source bash-args parse --port 3005 -- ls -L --color=always /lib <<-'EOF'
+bash-args parse --port 3005 -- ls -L --color=always /lib <<-'EOF'
 	@flag [port] {3000} - The port to open on
 EOF
 
@@ -26,7 +26,7 @@ A string that is a copy of standard input to `bash-args`
 ```sh
 declare argsRawSpec=
 
-source bash-args parse --port 3005 <<-'EOF'
+bash-args parse --port 3005 <<-'EOF'
 	@flag [port] {3000} - The port to open on
 	@flag [version.v] - Prints program version
 EOF
@@ -43,14 +43,14 @@ An associative array that contains the values of arguments
 ```sh
 declare -A args=()
 
-source bash-args parse --port 3005 <<-'EOF'
+bash-args parse --port 3005 <<-'EOF'
 	@flag [port.p] {3000} - The port to open on
 EOF
 
 echo "${args[port]} ${args[p]}"
 # 3005 3005
 
-source bash-args parse -p 3005 <<-'EOF'
+bash-args parse -p 3005 <<-'EOF'
 	@flag [port.p] {3000} - The port to open on
 EOF
 
@@ -65,7 +65,7 @@ An array contaning all the commands supplied
 ```sh
 declare -a argsCommands=()
 
-source bash-args parse --port 3005 serve --user admin now --enable-security <<-'EOF'
+bash-args parse --port 3005 serve --user admin now --enable-security <<-'EOF'
 	@flag [port.p] {3000} - The port to open on
 EOF
 
@@ -78,7 +78,7 @@ echo "${argsCommands[*]}"
 The full generated help text
 
 ```sh
-source bash-args parse parse "$@" <<-"EOF"
+bash-args parse parse "$@" <<-"EOF"
 @flag [port.p] {3000} - The port to open on
 EOF
 

docs/troubleshooting.md

@@ -7,6 +7,8 @@ If you are receiving opaque errors, the following may help
 Ensure `args` exists as an associate array and NOT an index array. Create it _before_ calling out to `bash-args`
 
 
+## Using indexed arrays instead of associative arrays
+
 ```sh
 # Wrong
 declare -a args
@@ -15,22 +17,6 @@ declare -a args
 declare -A args
 ```
 
-## Not sourcing `bash-args`
-
-If you do not source `bash-args` the variables that it sets will not be available to your current shell execution context
-
-```sh
-# Wrong
-bash-args parse "$@" <<-"EOF"
-@flag [port.p] {3000} - The port to open on
-EOF
-
-# Correct
-source bash-args parse parse "$@" <<-"EOF"
-@flag [port.p] {3000} - The port to open on
-EOF
-```
-
 ## Not declaring variables
 
 TODO: test this

load.bash

@@ -1,5 +1,7 @@
 # shellcheck shell=bash
 
+# TODO: use snake_case
+
 bash-args() {
 	case "$1" in
 	-h|--help)