matrix-org / matrix-org/matrix-hookshot

Update the content from the widget to the timeline when the user needs to configure integrations

Open
#1,071 0 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
TypeScript
Stars
450
Forks
95
Avg merge
1d 2h
Merged PRs (30d)
23

Description

Image

I think this content could be better phrased to give more guidance to the user.

Recognising that, in Element we call them Extensions which is double-y confusing for users, I still think we could write something clearer...

"Please open the Hookshot Configuration widget to set up integrations"

Ideas:
- "Head to Widgets or Extensions to configure integrations"
- "Please configure Hookshot"
- "Go to Hookshot Configuration to complete integration set up"

(OOI; I try to stay away from 'please' in content unless we're asking the user to go above and beyond as we run the risk of saying it too often and sounding false)

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Locate the content shown in the widget and timeline when users need to configure integrations, then review the surrounding UI terminology for Hookshot Configuration, Widgets, and Extensions. Update the guidance to clearly direct users to complete integration setup and verify the revised wording in both locations.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
content, frontend
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.