matrix-org / matrix-org/matrix-spec

Iterate on unban docs?

Open
#842 3 comments 0 reactions 0 assignees View on GitHub
clarification
Dominant language
HTML
Stars
330
Forks
150
Avg merge
2h 21m
Merged PRs (30d)
3

Description

The following quote is from the js-sdk, which feels like it might be useful knowledge to translate into the spec, whatever it means:
```
// unbanning != set their state to leave: this used to be
// the case, but was then changed so that leaving was always
// a revoking of privilege, otherwise two people racing to
// kick / ban someone could end up banning and then un-banning
// them.
```

Contributor guide

Open the contributing guide

Research direction

Start by reading the quoted unban behavior in the js-sdk and comparing it with the relevant Matrix specification text. Clarify whether the distinction between unbanning, leaving, and revoking privilege is already specified; done means the spec documents the intended behavior unambiguously.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.