matrix-js-sdk icon indicating copy to clipboard operation
matrix-js-sdk copied to clipboard

Docs are broken

Open bakkot opened this issue 3 years ago • 2 comments

For example, the docs for getRoom don't link the Room type. If you search for Room the closest you can get is this page, which does not list any of the actual methods on Room (instead it lists a random non-exported function defined in that file, presumably because it happens to have a jsdoc).

I was hoping to find some documentation suggesting how I can get the rooms in a space. There don't appear to be any helper methods for it. The closest I can find is getStateEvents(EventType.SpaceChild), where EventType is a value I can only seem to get by requiring a file from inside the package (require('matrix-js-sdk/lib/@types/event')). Surely there's a better way? But if there is, the documentation certainly doesn't suggest it.

bakkot avatar Sep 30 '21 05:09 bakkot

I'd really like to work on this but don't know where to start, anyone to provide pointers? @SimonBrandner @callahad

tawandamoyo avatar Nov 06 '21 18:11 tawandamoyo

Hi! Is there anything planned to improve the documentation?

dimitri-bourreau avatar Apr 21 '22 20:04 dimitri-bourreau

Hello, I would like to make improvements to the documentation for this project.

malehacker avatar Feb 10 '23 04:02 malehacker

This works correctly in my testing

Johennes avatar Nov 13 '23 13:11 Johennes