Skip to content

UX improvements: clearer copy, consistent naming, no fabricated replies#12

Open
alfredodelfabro wants to merge 9 commits into
developfrom
fix/ux-improvements
Open

UX improvements: clearer copy, consistent naming, no fabricated replies#12
alfredodelfabro wants to merge 9 commits into
developfrom
fix/ux-improvements

Conversation

@alfredodelfabro

Copy link
Copy Markdown
Member

Goals

Improve the Time-Off app's user-facing copy and behavior so it reads clearly, uses consistent naming, and never puts words in a user's mouth. These are UX refinements gathered from design feedback — no functional/data-model changes beyond how the reply message is stored.

Changes

Naming & copy consistency

  • Bot reply alias now shows as Time-off instead of "TimeOff Bot".
  • Normalized the app/help naming to "Time-off" across the help header and command list.

Slash command discoverability

  • Added an i18n description and params example so typing /time-off (before Enter) shows a friendly hint: "Manage your time off — start, end, or check your status" with start | end | status | help.

Clearer start confirmation

  • Reworded the /time-off start confirmation to emphasize the app only auto-replies to DMs and that the user must manually end with /time-off end.
  • When a custom message is provided, it's echoed back as a blockquote.
  • When no custom message is provided, the confirmation notes that no custom reply message was set.

Stop sending fabricated messages on the user's behalf

  • Removed the hardcoded default out-of-office reply ("I am out of office…") that the user never wrote.
  • When no custom message is set, senders now simply see that the user is on time off; when one is set, it's shown as a blockquote.
  • message is now optional on the time-off entry; /time-off status reflects whether a custom reply message was set.

DM reply presentation

  • Replaced the preview layout block with a section that renders the user's message as a > blockquote.

Notes

  • No migration needed — the bot alias is applied per message, so already-installed instances pick up the new name on redeploy.

- Normalize display name and help header to 'Time-off'
- Reword the not-started notification to clarify auto-reply is off
Add i18n description and params example so the slash command
autocomplete shows helpful usage text before the command runs.
Reword the 'not marked as Time Off' status reply to match the
not-started message, clarifying that auto-replies are off.
Replace the preview LayoutBlock with a section that quotes the
user's left-behind message using markdown blockquote formatting.
Reword the start confirmation to emphasize the app only auto-replies
to DMs and that the user must manually end with /time-off end. Show
the custom reply message as a blockquote when one is provided.
The app no longer stores or sends a default out-of-office message the
user never wrote. When no custom message is set, senders simply see
that the user is on time off, and the start confirmation and status
command note that no custom reply message was set.
@alfredodelfabro alfredodelfabro requested a review from scuciatto July 2, 2026 15:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant