update (almost) all taglines and descs

brew/install.sh

@@ -2,7 +2,8 @@
 
 # title: Homebrew
 # homepage: https://brew.sh
-# tagline: The Missing Package Manager for macOS (or Linux)
+# tagline: |
+#   Brew: The Missing Package Manager for macOS (and Linux).
 # description: |
 #   Homebrew installs the stuff you need that Apple (or your Linux system) didn’t.
 # examples: |

caddy/package.yash

@@ -1,8 +1,9 @@
 # title: Caddy
 # homepage: https://github.com/caddyserver/caddy
-# tagline: Fast, multi-platform web server with automatic HTTPS
+# tagline: |
+#   Caddy is a fast, multi-platform web server with automatic HTTPS.
 # description: |
-#   Caddy is an extensible server platform that uses TLS by default.
+#   Caddy makes it easy to use Let's Encrypt to handle HTTPS (TLS/SSL) and to reverse proxy APIs and WebSockets to other apps - such as those written node, Go, python, ruby, and PHP.
 # examples: |
 #   ```bash
 #   caddy start

flutter/package.yash

@@ -1,6 +1,7 @@
 # title: Flutter
 # homepage: https://flutter.dev
-# tagline: UI Toolkit for mobile, web, and desktop
+# tagline: |
+#   Flutter is a UI Toolkit for mobile, web, and desktop.
 # description: |
 #   Flutter is Google’s UI toolkit for building beautiful, natively compiled applications for mobile, web, and desktop from a single codebase.
 # examples: |

gitea/package.yash

@@ -1,11 +1,12 @@
 # title: Gitea
 # homepage: https://github.com/go-gitea/gitea
-# tagline: Git with a cup of tea, painless self-hosted git service
+# tagline: |
+#   Gitea: Git with a cup of tea, painless self-hosted git service.
 # description: |
-#   `gitea` is a clean, lightweight self-hosted Github alternative, forked from Gogs. Lighter and more user-friendly than Gitlab.
+#   Gitea is a clean, lightweight self-hosted Github clone. It only uses a few megabytes of RAM so it's perfect for hosting git on small VPSes and Raspberry Pis. It's forked from Gogs, and very familiar user-friendly for Github users in comparison to Gitlab or Bitbucket.
 # examples: |
 #   ```bash
-#   gitea --version
+#   gitea web --config $HOME/srv/git.example.com/custom/conf/app.ini
 #   ```
 
 END

golang/package.yash

@@ -1,8 +1,9 @@
 # title: Go
 # homepage: https://golang.org
-# tagline: The Go Programming Language tools
+# tagline: |
+#   Go makes it easy to build simple, reliable, and efficient software.
 # description: |
-#   Go is an open source programming language that makes it easy to build simple, reliable, and efficient software.
+#   Go is designed, through and through, to make Software Engineering easy. It's fast, efficient, reliably, and something you can learn in a weekend. If you subscribe to [_The Zen of Python_](https://www.python.org/dev/peps/pep-0020/), you'll [love](https://go-proverbs.github.io/) [Go](https://www.youtube.com/watch?v=PAAkCSZUG1c).
 # examples: |
 #   ```bash
 #   mkdir -p hello/

hugo/package.yash

@@ -1,14 +1,22 @@
 # title: Hugo
 # homepage: https://github.com/gohugoio/hugo
-# tagline: The world’s fastest framework for building websites
+# tagline: |
+#   Hugo: The world’s fastest framework for building websites.
 # description: |
-#   Hugo is one of the most popular open-source static site generators. With its amazing speed and flexibility, Hugo makes building websites fun again.
+#   Hugo is one of the most popular open-source static site generators. It makes building websites fun again.
 # examples: |
 #   ```bash
+#   # create a new site
+#   hugo new site ./blog.example.com
+#   ```
+#
+#   ```bash
+#   # compile a site
 #   hugo
 #   ```
 #
 #   ```bash
+#   # serve a site in dev mode
 #   hugo server -D
 #   ```
 

macos/install.sh

@@ -1,6 +1,7 @@
 # title: macOS
 # homepage: https://bootableinstaller.com/macos/
-# tagline: Bootable macOS Installer
+# tagline: |
+#   Creates a bootable macOS installer ISO in ~/Downloads.
 # description: |
 #   Downloads the official OS X / macOS dmg from Apple to create bootable installers - works from macOS, Linux, or even Windows (through VirtualBox).
 # examples: |

node/package.yash

@@ -1,9 +1,10 @@
 #
 # title: Node.js
 # homepage: https://nodejs.org
-# tagline: JavaScript V8 runtime
+# tagline: |
+#   Node.js® is a JavaScript runtime built on Chrome's V8 JavaScript engine.
 # description: |
-#   Node.js® is a JavaScript runtime built on Chrome's V8 JavaScript engine
+#   Node is great for simple, snappy HTTP(S) servers, and for stitching APIs together with minimal fuss or muss.
 # examples: |
 #
 #   ### Hello World

pathman/install.sh

@@ -2,7 +2,8 @@
 
 # title: Pathman
 # homepage: https://git.rootprojects.org/root/pathman
-# tagline: cross-platform PATH management for bash, zsh, fish, cmd.exe, and PowerShell
+# tagline: |
+#   Pathman: cross-platform PATH management for bash, zsh, fish, cmd.exe, and PowerShell.
 # description: |
 #   Manages PATH on various OSes and shells
 #     - Mac, Windows, Linux

postgres/package.yash

@@ -1,6 +1,7 @@
 # title: Postgres
 # homepage: https://www.postgresql.org/
-# tagline: PostgreSQL: The World's Most Advanced Open Source Relational Database
+# tagline: |
+#   PostgreSQL: The World's Most Advanced Open Source Relational Database.
 # description: |
 #   Postgres is the all-in-one database for beginners and experts alike. It handles SQL, 'NoSQL', JSON, HSTORE, Full-Text Search, Messages Queues and more. Best bang for buck.
 # examples: |

prettier/install.sh

@@ -1,6 +1,7 @@
 # title: Prettier
 # homepage: https://prettier.io/
-# tagline: Prettier is an opinionated code formatter.
+# tagline: |
+#   Prettier is an opinionated code formatter.
 # description: |
 #   The core value of Prettier is not in what it gives, but in what it takes away: countless hours of bikeshedding over code style choices. Also, it makes git merges much nicer.
 # examples: |

rg/package.yash

@@ -1,13 +1,13 @@
 # title: Ripgrep
 # homepage: https://github.com/BurntSushi/ripgrep
-# tagline: a modern drop-in grep replacement
-# alias: rg
+# tagline: |
+#   Ripgrep is a git and sourcecode-aware drop-in grep replacement.
 # description: |
-#   `rg` is a drop-in replacement for `grep`, that respects `.gitignore` and `.ignore`, has all of the sensible default options you want (colors, numbers, etc) turned on by default, is written in Rust, and simply outperforms grep in every imaginable way. R.I.P. grep.
+#   Ripgrep (`rg`) is smart. It's like grep if grep were built for code. It respects `.gitignore` and `.ignore`, has all of the sensible options you want (colors, numbers, etc) turned on by default, is written in Rust, and simply outperforms grep in every imaginable way. R.I.P. grep.
 # examples: |
 #
 #   ```bash
-#   rg <search-term> # searches recursively, ignoing .git, node_modules, etc
+#   rg <search-term> # searches recursively, ignoring .git, node_modules, etc
 #   ```
 #
 #   ```bash

rustlang/install.sh

@@ -2,11 +2,10 @@
 
 # title: Rust
 # homepage: https://rust-lang.org
-# tagline: The Rust Toolchain
+# tagline: |
+#   Rust: Empowering everyone to build reliable and efficient software.
 # description: |
-#   A language empowering everyone to build reliable and efficient software.
-#
-#   Rust is the modern language used to build all of your favorite CLI tools, such as
+#   Rust is what C++ and D were trying to do, but didn't. It's a modern, safe, high-performance language, which also just so happens to be used to build all of your favorite CLI tools, such as:
 #     - rg (ripgrep, modern grep)
 #     - fd (modern find)
 #     - sd (modern sed)

serviceman/install.sh

@@ -2,10 +2,10 @@
 
 # title: Serviceman
 # homepage: https://git.rootprojects.org/root/serviceman
-# tagline: cross-platform service management for Linux, Mac, and Windows
+# tagline: |
+#   Serviceman: cross-platform service management for Linux, Mac, and Windows.
 # description: |
-#   A system laucher that wraps `launchctl` (macOS), `systemctl` (Linux),
-#   and the Windows Registry to work cross-platform.
+#   Serviceman is a hassle-free wrapper around your system launcher. It works with `launchctl` (macOS), `systemctl` (Linux), and the Windows Registry to make it easy to start _user_ and _system_ level services, such as webservers, backup scripts, network and system tools, etc.
 # examples: |
 #
 #   Works with anything, including

vim-sensible/install.sh

@@ -2,11 +2,15 @@
 
 # title: vim-sensible
 # homepage: https://github.com/tpope/vim-sensible
-# tagline: sensible defaults for vim
+# tagline: |
+#   Vim Sensible: sensible defaults for vim
 # description: |
 #   Think of sensible.vim as one step above 'nocompatible' mode: a universal set of defaults that (hopefully) everyone can agree on.
 # examples: |
-#   N/A
+#
+#   Installs to `$HOME/.vim/pack/plugins/start`.
+#   It just works.
+#
 
 mkdir -p $HOME/.vim/pack/plugins/start
 rm -rf $HOME/.vim/pack/plugins/start/sensible

webi/install.sh

@@ -2,23 +2,48 @@
 
 # title: Webi
 # homepage: https://webinstall.dev
-# tagline: webinstall.dev for the CLI
+# tagline: |
+#   Webi is how developers install their tools.
 # description: |
-#   for the people like us that are too lazy even to run <kbd>curl&nbsp;https://webinstall.dev/PACKAGE_NAME&nbsp;|&nbsp;bash</kbd>
+#   Webi is what you would have created if you automated how you install your common tools yourself: Simple, direct downloads from official sources, unpacked into `$HOME/.local`, added to `PATH`, symlinked for easy version switching, with minimal niceties like resuming downloads and 'stable' tags.
+#   
+#   - Easy to remember.
+#   - No magic, no nonesense, no bulk.
+#   - What you would have done for yourself.
+#
 # examples: |
+#   You can install _exactly_ what you need, from memory, via URL:
+#
+#   ```bash
+#   curl https://webinstall.dev/node@lts | bash
+#   ```
+#
+#   Or via `webi`, the tiny `curl | bash` shortcut command that comes with each install:
+#
 #   ```bash
 #   webi node@latest
 #   ```
-#   <br/>
 #
 #   ```bash
 #   webi golang@v1.14
 #   ```
-#   <br/>
 #
 #   ```bash
 #   webi rustlang
 #   ```
+#
+#   You can see exactly what PATHs have been edited:
+#
+#   ```bash
+#   pathman list
+#   ```
+#
+#   And where:
+#
+#   ```bash
+#   cat $HOME/.config/envman/PATH.env
+#   ```
+#
 
 {