matrix-org / matrix-org/matrix.org

observation on https://matrix.org/docs/chat_basics/matrix-for-im/

Open
#1,932 0 comments 0 reactions 0 assignees View on GitHub
guides wording
Dominant language
JavaScript
Stars
616
Forks
463
Avg merge
2d 3h
Merged PRs (30d)
19

Description

Going to the docs page I was impressed by the clear concise information presented. I did find one paragraph jarred with the rest and thought it could be worded in sympathy with the others like this:

Creating a Matrix account

You can use any provider you want. The experts can even manage their own provider and accounts, but it's not a requirement at all. It is worth noting that when you create an account on a provider, your data can be migrated elsewhere at a later date.

Instead of...

Creating a Matrix account

You can use any provider you want. The experts can even set-up their own provider, but it's not a requirement at all. It is worth noting that when you create an account on a provider, you can use third-party tooling to migrate the chat rooms ownership to your new account, but this can be cumbersome in particular for DMs.

Contributor guide

Open the contributing guide

Research direction

Open the documentation page at docs/chat_basics/matrix-for-im/ and locate the “Creating a Matrix account” paragraph. Compare it with the wording proposed in the issue, update the paragraph if appropriate, and verify that the page presents the revised account and migration information clearly.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
1/5
Estimated time
Under an hour
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
50/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.