From 934193d90189b1419c7486fad8873cb48e05aad8 Mon Sep 17 00:00:00 2001 From: librelad Date: Thu, 20 Aug 2026 01:07:59 +0100 Subject: [PATCH] copy: drop deployment trivia from app descriptions MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit App descriptions are read by people deciding whether they want the app, not by people maintaining it. Several were spending their last clause on facts the reader cannot act on and would not recognise — and in Stoat's case actively talking the app down: "Heavy (16 containers) and does not federate" is a maintainer's note, not a description. Eight rewritten, all the same fault: stoat "Heavy (16 containers) and does not federate", and LiveKit named as though the reader would know what it is vikunja "Runs as a single container on SQLite, with no database sidecar" stalwart "in a single container" gitea "written in Go", plus "self-hosted Git service" twice in one line vaultwarden "an alternative implementation of the Bitwarden server API written in Rust" — says what it is to a developer, not what it does for you speedtest "implemented in Javascript" adguard "resolving blocked domains to a local blackhole address" matrix "Installs Synapse plus the Element web client" Deliberately kept, because they change whether the app suits you rather than merely describing how it is built: Rocket.Chat's free-edition user cap, Mattermost's unlimited users, Navidrome's Subsonic compatibility (it tells you which phone apps will work), Stalwart's protocol list, and Gluetun's provider count. Co-Authored-By: Claude Opus 5 --- containers/adguard/adguard.config | 2 +- containers/gitea/gitea.config | 2 +- containers/matrix/matrix.config | 2 +- containers/speedtest/speedtest.config | 2 +- containers/stalwart/stalwart.config | 2 +- containers/stoat/stoat.config | 2 +- containers/vaultwarden/vaultwarden.config | 2 +- containers/vikunja/vikunja.config | 2 +- 8 files changed, 8 insertions(+), 8 deletions(-) diff --git a/containers/adguard/adguard.config b/containers/adguard/adguard.config index 938d987..0216ff4 100755 --- a/containers/adguard/adguard.config +++ b/containers/adguard/adguard.config @@ -44,7 +44,7 @@ CFG_ADGUARD_MONITORING=false CFG_ADGUARD_CATEGORY="networking" CFG_ADGUARD_TITLE="AdGuard" CFG_ADGUARD_DESCRIPTION="DNS based Ad Blocking" -CFG_ADGUARD_LONG_DESCRIPTION="AdGuard Home is a network-wide ad and tracker blocker that works as a DNS server, resolving blocked domains to a local blackhole address" +CFG_ADGUARD_LONG_DESCRIPTION="A network-wide ad and tracker blocker that protects every device on your network, with no software to install on them" CFG_ADGUARD_URL="https://github.com/AdguardTeam/AdGuardHome" CFG_ADGUARD_ACTIONS="configure|install|restart|shutdown|uninstall" # diff --git a/containers/gitea/gitea.config b/containers/gitea/gitea.config index d81898b..f577e72 100755 --- a/containers/gitea/gitea.config +++ b/containers/gitea/gitea.config @@ -41,7 +41,7 @@ CFG_GITEA_METRICS_TOKEN_1=RANDOMIZEDPASSWORD1 CFG_GITEA_CATEGORY="development" CFG_GITEA_TITLE="Gitea" CFG_GITEA_DESCRIPTION="Git Repository Management" -CFG_GITEA_LONG_DESCRIPTION="Gitea is a lightweight, self-hosted Git service written in Go that provides a painless self-hosted Git service with a minimal setup" +CFG_GITEA_LONG_DESCRIPTION="A lightweight, self-hosted Git service for your own repositories, issues and pull requests" CFG_GITEA_URL="https://github.com/go-gitea/gitea" CFG_GITEA_ACTIONS="configure|install|restart|shutdown|uninstall" # diff --git a/containers/matrix/matrix.config b/containers/matrix/matrix.config index a7b272c..74c5960 100644 --- a/containers/matrix/matrix.config +++ b/containers/matrix/matrix.config @@ -80,7 +80,7 @@ CFG_MATRIX_DB_PASSWORD_1=RANDOMIZEDPASSWORD2 CFG_MATRIX_CATEGORY="communication" CFG_MATRIX_TITLE="Matrix" CFG_MATRIX_DESCRIPTION="Federated Chat" -CFG_MATRIX_LONG_DESCRIPTION="The open federated chat protocol — rooms, end-to-end encryption and bridges to Discord and Slack. Installs Synapse plus the Element web client" +CFG_MATRIX_LONG_DESCRIPTION="The open federated chat protocol — rooms, end-to-end encryption and bridges to Discord and Slack. Includes a web client" CFG_MATRIX_URL="https://github.com/element-hq/synapse" CFG_MATRIX_ACTIONS="configure|install|restart|shutdown|uninstall" # diff --git a/containers/speedtest/speedtest.config b/containers/speedtest/speedtest.config index 74c18a7..11549cc 100755 --- a/containers/speedtest/speedtest.config +++ b/containers/speedtest/speedtest.config @@ -45,7 +45,7 @@ CFG_SPEEDTEST_PASSWORD_1=RANDOMIZEDPASSWORD1 CFG_SPEEDTEST_CATEGORY="networking" CFG_SPEEDTEST_TITLE="LibreSpeed" CFG_SPEEDTEST_DESCRIPTION="Network Performance Monitoring" -CFG_SPEEDTEST_LONG_DESCRIPTION="Lightweight speedtest implemented in Javascript that provides accurate network speed measurements" +CFG_SPEEDTEST_LONG_DESCRIPTION="A lightweight network speed test you can run from any browser on your network" CFG_SPEEDTEST_URL="https://github.com/librespeed/speedtest" CFG_SPEEDTEST_ACTIONS="configure|install|restart|shutdown|uninstall" # diff --git a/containers/stalwart/stalwart.config b/containers/stalwart/stalwart.config index d2ce678..dbe45bf 100644 --- a/containers/stalwart/stalwart.config +++ b/containers/stalwart/stalwart.config @@ -52,7 +52,7 @@ CFG_STALWART_HEADSCALE=false CFG_STALWART_CATEGORY="communication" CFG_STALWART_TITLE="Stalwart" CFG_STALWART_DESCRIPTION="Mail Server" -CFG_STALWART_LONG_DESCRIPTION="An all-in-one mail and collaboration server — SMTP, IMAP, POP3 and JMAP plus calendars and contacts, in a single container" +CFG_STALWART_LONG_DESCRIPTION="An all-in-one mail and collaboration server — SMTP, IMAP, POP3 and JMAP plus calendars and contacts" CFG_STALWART_URL="https://github.com/stalwartlabs/stalwart" CFG_STALWART_ACTIONS="configure|install|restart|shutdown|uninstall" # diff --git a/containers/stoat/stoat.config b/containers/stoat/stoat.config index 1fa48a9..b5879a2 100644 --- a/containers/stoat/stoat.config +++ b/containers/stoat/stoat.config @@ -110,7 +110,7 @@ CFG_STOAT_INVITE_ONLY=true CFG_STOAT_CATEGORY="communication" CFG_STOAT_TITLE="Stoat" CFG_STOAT_DESCRIPTION="Discord-style Chat" -CFG_STOAT_LONG_DESCRIPTION="The closest open-source match to Discord — servers, channels, roles, and LiveKit voice and video. Heavy (16 containers) and does not federate" +CFG_STOAT_LONG_DESCRIPTION="The closest open-source match to Discord — servers, channels, roles, and voice and video chat" CFG_STOAT_URL="https://github.com/stoatchat/self-hosted" CFG_STOAT_ACTIONS="configure|install|restart|shutdown|uninstall" # diff --git a/containers/vaultwarden/vaultwarden.config b/containers/vaultwarden/vaultwarden.config index 77c34d7..ef4b30b 100755 --- a/containers/vaultwarden/vaultwarden.config +++ b/containers/vaultwarden/vaultwarden.config @@ -48,7 +48,7 @@ CFG_VAULTWARDEN_SIGNUPS_ALLOWED=true CFG_VAULTWARDEN_CATEGORY="security" CFG_VAULTWARDEN_TITLE="Vaultwarden" CFG_VAULTWARDEN_DESCRIPTION="Password Manager" -CFG_VAULTWARDEN_LONG_DESCRIPTION="Vaultwarden is an alternative implementation of the Bitwarden server API written in Rust and compatible with Bitwarden clients" +CFG_VAULTWARDEN_LONG_DESCRIPTION="A self-hosted password manager that works with all the official Bitwarden apps and browser extensions" CFG_VAULTWARDEN_URL="https://github.com/dani-garcia/vaultwarden" CFG_VAULTWARDEN_ACTIONS="configure|install|restart|shutdown|uninstall" # diff --git a/containers/vikunja/vikunja.config b/containers/vikunja/vikunja.config index bb1243b..b4799e1 100644 --- a/containers/vikunja/vikunja.config +++ b/containers/vikunja/vikunja.config @@ -39,7 +39,7 @@ CFG_VIKUNJA_MONITORING=false CFG_VIKUNJA_CATEGORY="productivity" CFG_VIKUNJA_TITLE="Vikunja" CFG_VIKUNJA_DESCRIPTION="Tasks & Project Management" -CFG_VIKUNJA_LONG_DESCRIPTION="Organises tasks and projects as lists, kanban boards, tables or a gantt timeline. Runs as a single container on SQLite, with no database sidecar" +CFG_VIKUNJA_LONG_DESCRIPTION="Organises tasks and projects as lists, kanban boards, tables or a gantt timeline" CFG_VIKUNJA_URL="https://vikunja.io" CFG_VIKUNJA_ACTIONS="configure|install|restart|shutdown|uninstall" #