From 05d2dfd9cd7bed05cb01f50caed47bcf0953d08f Mon Sep 17 00:00:00 2001
From: Zhaoxuan Chen <zc200@students.waikato.ac.nz>
Date: Tue, 30 Sep 2025 22:24:19 +0800
Subject: [PATCH] docs(widgets): document hideDetails for public-ip widget

- Add hideDetails parameter to options table with description
- Include usage scenarios: privacy, minimal dashboards, quick IP checks
- Add example configuration for hideDetails=true
- Include placeholder for before/after comparison screenshots
---
 docs/widgets.md | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/docs/widgets.md b/docs/widgets.md
index 52dc5c1f..5acb2b5a 100644
--- a/docs/widgets.md
+++ b/docs/widgets.md
@@ -293,7 +293,10 @@ Often find yourself searching "What's my IP", just so you can check your VPN is
 
 <p align="center"><img width="400" src="https://i.ibb.co/vc3c8zN/public-ip.png" /></p>
 
-You can optionally hide geographical details (city, region, ISP, flag) and show only the IP address by setting `hideDetails: true`.
+You can optionally hide geographical details (city, region, ISP, flag) and show only the IP address by setting `hideDetails: true`. This is useful for:
+- **Privacy concerns** - when you don't want to expose location information
+- **Minimal dashboards** - for cleaner, more compact layouts
+- **Quick IP checks** - when you only need to verify your public IP
 
 <p align="center">
   <img width="400" src="./assets/public-ip-full-details.png" alt="Public IP with full details" />