docs: add friendly hover tips for new terms (#3740)

.vale/styles/config/vocabularies/Atuin/accept.txt

@@ -27,6 +27,7 @@ autostart
 autosuggest
 bindable
 Caddy
+ciphertext
 deserialization
 devcontainers
 dirs
@@ -53,12 +54,14 @@ OAuth
 Ollama
 opencode
 Pacman
+plaintext
 Podman
 Postgres
 PowerShell
 Pulumi
 reenabling
 replxx
+runbooks
 SQLite
 subshells
 sudo
@@ -66,6 +69,7 @@ systemd
 Termux
 tmux
 toolchain
+tooltips
 Traefik
 unhighlighted
 unstyled

docs/includes/abbreviations.md

@@ -0,0 +1,24 @@
+<!--
+  - Keep every definition on ONE line. A wrapped line silently truncates the
+    tooltip and renders the overflow as a stray code block on every page.
+-->
+
+*[CLI]: Command-line interface — a program you use by typing commands in a terminal instead of clicking around a window
+*[Docker]: A tool that bundles a program with everything it needs so it runs the same way on any computer; each bundle is called a container
+*[E2E encryption]: End-to-end encryption — your data is scrambled on your own device before it leaves it, so nobody in between (not even the server) can read it
+*[Hub]: Atuin Hub — Atuin's hosted service that stores your account and syncs your history for you
+*[Kubernetes]: A system for running and scaling lots of containers across many machines; one way to self-host Atuin at larger scale
+*[LLM]: Large language model — the kind of AI (like Claude or GPT) that powers Atuin's command generation
+*[MCP]: Model Context Protocol — a shared standard that lets AI assistants plug into tools like Atuin, for example to search your history
+*[PTY]: Pseudo-terminal — the behind-the-scenes channel a program uses to send text to and read text from your terminal
+*[PostgreSQL]: A popular, powerful open-source database; the recommended storage for a self-hosted Atuin server
+*[Postgres]: Short for PostgreSQL — a popular open-source database; the recommended storage for a self-hosted Atuin server
+*[SQLite]: A lightweight database that lives in a single file on your computer; where Atuin keeps your shell history locally
+*[SSH]: Secure Shell — a secure way to log in to and run commands on another computer over a network
+*[TLS]: The standard encryption that protects data as it travels the internet — the same technology behind the padlock in your browser
+*[UUID]: A long, randomly generated ID that is effectively unique, so different machines can create them without ever clashing
+*[daemon]: A program that runs quietly in the background; Atuin's daemon makes history writes instant and syncs on a schedule
+*[dotfiles]: Your shell's personal settings — aliases, functions, and environment variables — which Atuin can sync across your machines
+*[frecency]: A ranking that blends how often and how recently you have run a command, so your go-to commands show up first
+*[regex]: Regular expression — a compact pattern for matching text, for example finding every command that starts with "git"
+*[systemd]: The service manager on most Linux systems; it starts and supervises background programs like the Atuin daemon or server

docs/mkdocs.yml

@@ -56,6 +56,7 @@ theme:
     - content.code.copy            # copy affordance on terminal
     - content.action.edit          # edit the page easily
     - content.action.view          # view the raw md
+    - content.tooltips             # improved tooltips for abbreviations
 
 plugins:
   - search
@@ -214,6 +215,10 @@ markdown_extensions:
       alternate_style: true
   - admonition
   - pymdownx.details
+  - abbr
+  - pymdownx.snippets:
+      auto_append:
+        - includes/abbreviations.md
   - attr_list
   - md_in_html
   - tables