matrix-org / matrix-spec

The Matrix protocol specification
Apache License 2.0
193 stars 96 forks source link

Lazy load text has inconsistent url parameter notation #1982

Open MTRNord opened 2 weeks ago

MTRNord commented 2 weeks ago

Link to problem area: https://spec.matrix.org/v1.12/client-server-api/#lazy-loading-room-members

Issue An image speaks more than a thousand words: grafik

Expected behaviour The url parameter style should be consistent across endpoints.

MTRNord commented 2 weeks ago

Oh since there is possibly confusing highlighting: I am referring to <room_id> vs {roomId} as well as the snake_case vs camelCase style

zecakeh commented 1 week ago

FWIW, since I am guessing that the {roomId} "OpenAPI" style, which is used for the endpoints definitions should prevail to be consistent across the spec, there are more references to endpoints using the <id> format at least in the CS API. Searching for rooms/<room_id> and user/<user_id> should find most of them.