From eeaa8db394e92b53b0031fa62b33b969366a7913 Mon Sep 17 00:00:00 2001 From: AJ ONeal Date: Wed, 17 Jun 2020 00:10:00 +0000 Subject: [PATCH] update (almost) all taglines and descs --- brew/install.sh | 3 ++- caddy/package.yash | 5 +++-- flutter/package.yash | 3 ++- gitea/package.yash | 7 ++++--- golang/package.yash | 5 +++-- hugo/package.yash | 12 ++++++++++-- macos/install.sh | 3 ++- node/package.yash | 5 +++-- pathman/install.sh | 3 ++- postgres/package.yash | 3 ++- prettier/install.sh | 3 ++- rg/package.yash | 8 ++++---- rustlang/install.sh | 7 +++---- serviceman/install.sh | 6 +++--- vim-sensible/install.sh | 8 ++++++-- webi/install.sh | 33 +++++++++++++++++++++++++++++---- 16 files changed, 80 insertions(+), 34 deletions(-) diff --git a/brew/install.sh b/brew/install.sh index e95a572..5826161 100644 --- a/brew/install.sh +++ b/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: | diff --git a/caddy/package.yash b/caddy/package.yash index 6ac8fcd..8993130 100644 --- a/caddy/package.yash +++ b/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 diff --git a/flutter/package.yash b/flutter/package.yash index e9413ff..a4f672d 100644 --- a/flutter/package.yash +++ b/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: | diff --git a/gitea/package.yash b/gitea/package.yash index 1eacd29..040674f 100644 --- a/gitea/package.yash +++ b/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 diff --git a/golang/package.yash b/golang/package.yash index 447e3d8..01e34bb 100644 --- a/golang/package.yash +++ b/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/ diff --git a/hugo/package.yash b/hugo/package.yash index 4cf4941..ece6af3 100644 --- a/hugo/package.yash +++ b/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 # ``` diff --git a/macos/install.sh b/macos/install.sh index dd5566b..7a47bdc 100644 --- a/macos/install.sh +++ b/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: | diff --git a/node/package.yash b/node/package.yash index a10af04..e7508ec 100644 --- a/node/package.yash +++ b/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 diff --git a/pathman/install.sh b/pathman/install.sh index 309befc..ba1601a 100644 --- a/pathman/install.sh +++ b/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 diff --git a/postgres/package.yash b/postgres/package.yash index 488bd94..bf91145 100644 --- a/postgres/package.yash +++ b/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: | diff --git a/prettier/install.sh b/prettier/install.sh index e6b987a..9053c83 100644 --- a/prettier/install.sh +++ b/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: | diff --git a/rg/package.yash b/rg/package.yash index 7c11c6f..33c6f6a 100644 --- a/rg/package.yash +++ b/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 # searches recursively, ignoing .git, node_modules, etc +# rg # searches recursively, ignoring .git, node_modules, etc # ``` # # ```bash diff --git a/rustlang/install.sh b/rustlang/install.sh index e95f172..696fca9 100644 --- a/rustlang/install.sh +++ b/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) diff --git a/serviceman/install.sh b/serviceman/install.sh index df80877..690d44a 100644 --- a/serviceman/install.sh +++ b/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 diff --git a/vim-sensible/install.sh b/vim-sensible/install.sh index e19a75b..08d2ba5 100644 --- a/vim-sensible/install.sh +++ b/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 diff --git a/webi/install.sh b/webi/install.sh index c5730b2..535598d 100644 --- a/webi/install.sh +++ b/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 curl https://webinstall.dev/PACKAGE_NAME | bash +# 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 # ``` -#
# # ```bash # webi golang@v1.14 # ``` -#
# # ```bash # webi rustlang # ``` +# +# You can see exactly what PATHs have been edited: +# +# ```bash +# pathman list +# ``` +# +# And where: +# +# ```bash +# cat $HOME/.config/envman/PATH.env +# ``` +# { -- 2.25.1