docs: Cleanup wording

Author: hyperupcall

README.md

@@ -2,53 +2,34 @@
 
 System for choosing default applications, programs, and utilities
 
-Like `update-alternatives`, but local to user and more flexible. Requires a database of applications and their defaults at `"${XDG_CONFIG_HOME:-$HOME/.config}/chooses/defaults"`
-
-## Summary
-
-- Default application manager
-  - Double click on file / launch with xdg-open, we control that
-    - Abstract image/png, image/jpeg etc. behind 'image-viewer'. associate with single app at a time
-- Default application exec
-  - Execute command associated with utility (ex. 'image-viewer's)
-
-## Installation
-
-Use [Basalt](https://github.com/hyperupcall/basalt), a Bash package manager, to install this project globally
-
-```sh
-basalt global add hyperupcall/choose
-```
+## Use Cases
 
-## Environment Variables
-
-- CHOOSE_DB_DIR
-  - by default at `$XDG_CONFIG_HOME/choose/db`
+Like `update-alternatives`, but local to user and more flexible. Requires a database of applications and their defaults at `"${XDG_CONFIG_HOME:-$HOME/.config}/chooses/defaults"`
 
-## Folder Structure
+1. Launch with file
 
-The author's config can be found [here](https://github.com/hyperupcall/dots/tree/main/user/.config/choose/db)
-- db
+Control which applications are selected when opening a file. This works irrespective of the desktop environment. `xdg-open` falls flat because it doesn't work with directories. Furthermore, different applications can be configured to work in a different context (X, Terminal emulator, Linux console).
 
-  - terminal-emulator
+Since these are just shell scripts, arbitrary arguments should be supported, like `--column` and `--row` for example, if using a text editor.
 
-    - alacritty
-    - kitty
-      - launch.sh
-      - set.sh
-      - get.sh
-    - termite
+2. Launch without file
 
-    - launch.sh
-    - set.sh
-    - get.sh
+The current 'Browser' or 'Image Viewer' can be launched. Again, this is intended to work across distributions and user interfaces.
 
-  - image-viewer
+See more info in [details.md](./docs/details.md)
 
-## TODO
+## Roadmap
 
 - 'get' subcommand
 - use choose when using fuzzer / filter (dmenu vs rofi -dmenu, etc.)
 - application categories standardizable?
 - new command
 - sourcing pre-exec does does output on --verbose flag (or another)
+
+## Installation
+
+Use [Basalt](https://github.com/hyperupcall/basalt), a Bash package manager, to install this project globally
+
+```sh
+basalt global add hyperupcall/choose
+```

docs/details.md

@@ -30,3 +30,8 @@ db
    - xmobar/
      - launch.sh
 ```
+
+## Environment Variables
+
+- CHOOSE_DB_DIR
+  - by default at `$XDG_CONFIG_HOME/choose/db`