matrix-org / matrix-org/matrix-spec
Clarify the Historical User IDs grammar to include empty localparts
- Dominant language
- HTML
- Stars
- 330
- Forks
- 150
- Avg merge
- 2h 21m
- Merged PRs (30d)
- 3
Description
**Link to problem area**: https://spec.matrix.org/v1.4/appendices/#historical-user-ids
**Issue**
The spec should say that empty localparts are acceptable as historical User IDs; e.g. `@:matrix.org` is valid as a User ID (unfortunately) but servers should not allow this to be registered.
This would 'conflict' with
> **It MUST NOT be empty**, and MUST contain only the characters a-z, 0-9, ., _, =, -, and /.
but we already 'conflict' with that when introducing the expanded character set for historical User IDs, so I think this would be more honest and clearer for implementers.
Contributor guide
Research direction
Open the Historical User IDs section at the linked specification page and review the grammar around empty localparts and the existing character-set exception. Clarify that empty localparts such as `@:matrix.org` are valid historically while servers must not allow them to be registered; done when the wording is unambiguous for implementers.
Written by the indexing model from the issue text.
Assessment
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Stale
- Clarity
- Clearly specified
- Newbie friendliness
- 45/100