Tool descriptions were leaking internal vocabulary (Django superuser,
Postgres bcrypt update, htpasswd in protectionauth.yml, gitea admin
user change-password CLI, trusted_domains list, …) and repeating the
label as a full sentence. Beginners don't care, and even experienced
users don't need the CLI name to know what a button does.
Rewrites every tool description to a single short sentence plain
enough that a first-time installer can read it without context.
Conventions applied across the board:
- One sentence, sentence-case
- Plain English: "Set a new password", "Add a new user",
"Permanently remove a user", "List every user"
- "Leave blank to generate one" only where it's actually useful
(password fields), and matches the field placeholder text
- No CLI names, no schema field names, no internal file paths
- Destructive actions stop saying "permanently" twice (the action
label + the confirm modal already cover that)
- Field placeholders harmonised: "Leave blank for random" /
"Leave blank to generate" → consistently "Leave blank to generate"
Touched files (descriptions only — no logic, no fields removed):
containers/adguard/tools/adguard.tools.json
containers/bookstack/tools/bookstack.tools.json
containers/dashy/tools/dashy.tools.json
containers/focalboard/tools/focalboard.tools.json
containers/gitea/tools/gitea.tools.json
containers/gluetun/tools/gluetun.tools.json
containers/invidious/tools/invidious.tools.json
containers/linkding/tools/linkding.tools.json
containers/nextcloud/tools/nextcloud.tools.json
containers/pihole/tools/pihole.tools.json
containers/traefik/tools/traefik.tools.json
Signed-off-by: librelad <librelad@digitalangels.vip>
78 lines
1.8 KiB
JSON
78 lines
1.8 KiB
JSON
{
|
|
"tools": [
|
|
{
|
|
"id": "reset_password",
|
|
"category": "users",
|
|
"label": "Reset User Password",
|
|
"description": "Set a new password for an existing user. Leave blank to generate one.",
|
|
"icon": "🔑",
|
|
"fields": [
|
|
{
|
|
"name": "email",
|
|
"label": "Email",
|
|
"type": "text",
|
|
"required": true
|
|
},
|
|
{
|
|
"name": "password",
|
|
"label": "New password",
|
|
"type": "password",
|
|
"placeholder": "Leave blank to generate"
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"id": "create_account",
|
|
"category": "users",
|
|
"label": "Create User Account",
|
|
"description": "Add a new user. Sign-in uses the email address.",
|
|
"icon": "👤",
|
|
"fields": [
|
|
{
|
|
"name": "email",
|
|
"label": "Email",
|
|
"type": "text",
|
|
"required": true
|
|
},
|
|
{
|
|
"name": "password",
|
|
"label": "Password",
|
|
"type": "password",
|
|
"placeholder": "Leave blank to generate"
|
|
},
|
|
{
|
|
"name": "admin",
|
|
"label": "Make admin",
|
|
"type": "checkbox",
|
|
"default": false
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"id": "list_users",
|
|
"category": "users",
|
|
"label": "List Users",
|
|
"description": "List every user.",
|
|
"icon": "📋",
|
|
"fields": []
|
|
},
|
|
{
|
|
"id": "delete_user",
|
|
"category": "users",
|
|
"label": "Delete User Account",
|
|
"description": "Permanently remove a user.",
|
|
"icon": "🗑",
|
|
"destructive": true,
|
|
"confirm": "This cannot be undone.",
|
|
"fields": [
|
|
{
|
|
"name": "email",
|
|
"label": "Email",
|
|
"type": "text",
|
|
"required": true
|
|
}
|
|
]
|
|
}
|
|
]
|
|
}
|