From 0c535916eb5bd9832b6194b2d84fe3af1c7be956 Mon Sep 17 00:00:00 2001 From: Bram van den Heuvel Date: Thu, 16 Mar 2023 10:24:03 +0100 Subject: [PATCH] Add documentation to exposed modules --- src/Matrix.elm | 14 ++++++++++++-- src/Matrix/Room.elm | 21 +++++++++++++++++++-- src/Matrix/RoomInvite.elm | 8 +++++++- 3 files changed, 38 insertions(+), 5 deletions(-) diff --git a/src/Matrix.elm b/src/Matrix.elm index 24497df..d752fcd 100644 --- a/src/Matrix.elm +++ b/src/Matrix.elm @@ -1,4 +1,9 @@ -module Matrix exposing (..) +module Matrix exposing + ( Vault, fromLoginCredentials, fromAccessToken + , sync, VaultUpdate, updateWith + , getRooms, getRoomById, getInvites + , joinRoomById + ) {-| This is the main module of the SDK. Here, you will find basic functions to interact with the API. @@ -16,7 +21,12 @@ interact with the API. # Exploring your vault -@docs getRooms, getRoomById, accessToken +@docs getRooms, getRoomById, getInvites + + +# Taking action + +@docs joinRoomById -} diff --git a/src/Matrix/Room.elm b/src/Matrix/Room.elm index 8c27802..da88437 100644 --- a/src/Matrix/Room.elm +++ b/src/Matrix/Room.elm @@ -1,6 +1,23 @@ -module Matrix.Room exposing (..) +module Matrix.Room exposing + ( Room, roomId, mostRecentEvents + , sendMessage, sendMessages, sendOneEvent, sendMultipleEvents + ) -{-| -} +{-| This module provides functions for working with Matrix rooms. + + +# Room + +A room represents a channel of communication within a Matrix home server. + +@docs Room, roomId, mostRecentEvents + + +# Sending events + +@docs sendMessage, sendMessages, sendOneEvent, sendMultipleEvents + +-} import Internal.Api.VaultUpdate exposing (VaultUpdate) import Internal.Event as Event diff --git a/src/Matrix/RoomInvite.elm b/src/Matrix/RoomInvite.elm index 88bcd3d..c9507b8 100644 --- a/src/Matrix/RoomInvite.elm +++ b/src/Matrix/RoomInvite.elm @@ -1,4 +1,4 @@ -module Matrix.RoomInvite exposing (..) +module Matrix.RoomInvite exposing (RoomInvite, accept, reject, acceptWithReason, rejectWithReason) {-| Sometimes, your user will be invited to a new room! This module offers you a few simple handles to deal with such invites - @@ -18,6 +18,12 @@ Be careful though, anyone can invite you to any room! This means that room invit may contain offensive, shocking or other unwanted content that the user may not want to see. +@docs RoomInviteEvent getEvent, getAllEvents + +Once you have the event you want, you can explore it with the following functions. + +@docs sender, stateKey, contentType, content + -} import Internal.Api.VaultUpdate exposing (VaultUpdate)