From e3edef774536d3c4bde4286e53f60ec82c17a49a Mon Sep 17 00:00:00 2001
From: Michele Cereda <cereda.michele@gmail.com>
Date: Fri, 27 Jun 2025 21:11:29 +0200
Subject: [PATCH] chore(kb/whalebrew): review and expand

---
 knowledge base/whalebrew.md | 50 ++++++++++++++++++++++++++++++-------
 1 file changed, 41 insertions(+), 9 deletions(-)

diff --git a/knowledge base/whalebrew.md b/knowledge base/whalebrew.md
index 052b200..0e2f0a8 100644
--- a/knowledge base/whalebrew.md	
+++ b/knowledge base/whalebrew.md	
@@ -5,17 +5,47 @@
 
 ## TL;DR
 
-<!-- Uncomment if used
-<details>
-  <summary>Installation and configuration</summary>
-</details>
--->
+Installs images like `whalebrew/wget` as `/usr/local/bin/wget`.
+
+<details>
+  <summary>Setup</summary>
+
+Requires [Docker].
+
+```sh
+brew install 'whalebrew'
+```
+
+</details>
 
-<!-- Uncomment if used
 <details>
   <summary>Usage</summary>
+
+Images from the [_whalebrew_ organization][whalebrew organization] are known to work correctly.<br/>
+One can install any other image on Docker Hub, though they might not work as well.
+
+> [!important]
+> All `whalebrew/` images seem to be extremely dated at the time of writing.
+
+```sh
+# Search packages.
+whalebrew search 'wget'
+
+# Install packages.
+whalebrew install 'whalebrew/wget'
+whalebrew install 'bfirsh/ffmpeg'
+
+# List installed packages.
+whalebrew list
+
+# Upgrade packages.
+docker pull 'whalebrew/wget'
+
+# Uninstall packages.
+whalebrew uninstall 'wget'
+```
+
 </details>
--->
 
 <!-- Uncomment if used
 <details>
@@ -25,7 +55,7 @@
 
 ## Further readings
 
-- [Github]
+- [Codebase]
 - [Homebrew]
 
 <!--
@@ -36,9 +66,11 @@
 <!-- In-article sections -->
 <!-- Knowledge base -->
 [homebrew]: homebrew.md
+[docker]: docker.md
 
 <!-- Files -->
 <!-- Upstream -->
-[github]: https://github.com/whalebrew/whalebrew
+[codebase]: https://github.com/whalebrew/whalebrew
 
 <!-- Others -->
+[whalebrew organization]: https://hub.docker.com/u/whalebrew