bring on more tildes hopefully

pages/list-html-connections/README.md

@@ -0,0 +1,20 @@
+# Connection-list utility
+
+`social.sh` and `ack2list.pl` are retained historical utilities. The shell
+pipeline uses `ack` to find local tilde links, then the Perl script generates an
+HTML table. `css/social.css` supplies the stylesheet.
+
+The original pipeline assumes a working directory containing `ack2list.pl` and
+an output directory named `public_html`. It scans `/home`, has hard-coded
+exclusions, and does not safely escape all filesystem/link values as HTML.
+It is not an appropriate root job or a web-request handler on a new shared host.
+
+Before using a reviewed copy, restrict scanning to intended public HTML,
+handle permissions and symlinks, bound the scan, validate/escape the output,
+and publish atomically from staging. Decide whether indexing is opt-in and
+how members exclude a page. Preserve other people's private files and do not
+interpret local links as shell commands.
+
+The docs refresh keeps the utility and stylesheet intact for existing users.
+See [community tooling](../../docs/community.md) for the current deployment
+approach and [the setup guide](../../docs/how-to-set-up-a-tilde.md) for the host.