Skip to content

Commit

Permalink
Merge pull request #4034 from esl/update-muc-light-docs
Browse files Browse the repository at this point in the history
Update MUC Light docs
  • Loading branch information
chrzaszcz committed Jun 13, 2023
2 parents 0bd9702 + dee05a1 commit dbb1cd4
Showing 1 changed file with 7 additions and 6 deletions.
13 changes: 7 additions & 6 deletions doc/open-extensions/muc_light.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
## 1. Introduction

Classic Multi-User chat, as described in XEP-0045, adds an IRC-like functionality to XMPP.
It distinguishes between the affiliation list and the occupant list, where the latter is based on presences routed to the room from the client resource.
While perfectly sufficient for desktop applications and relatively stable network connection, it does not exactly meet the challenges the mobile world it is facing.
Modern mobile applications do not rely on presence information, as it can frequently change. The expected user experience not only differs from the IRC model, but also uses only a small subset of XEP-0045 features.
The service described in this specification attempts to provide a complete solution for all common use cases of mobile groupchats.
Classic Multi-User chat, as described in XEP-0045, adds an IRC-like functionality to XMPP.
It distinguishes between the affiliation list and the occupant list, where the latter is based on presences routed to the room from the client resource.
While perfectly sufficient for desktop applications and relatively stable network connection, it does not exactly meet the challenges the mobile world it is facing.
Modern mobile applications do not rely on presence information, as it can frequently change. The expected user experience not only differs from the IRC model, but also uses only a small subset of XEP-0045 features.
The service described in this specification attempts to provide a complete solution for all common use cases of mobile group chats.

## 2. Requirements

Expand Down Expand Up @@ -1293,13 +1293,14 @@ It occurs in the following cases:

## 8. Implementation Notes

### 8.1. XEP-0045 mappings
### 8.1. XEP-0045 mappings a.k.a. legacy mode

Some client-side developers might choose to use existing XEP-0045 Multi-User Chat implementations
to interface with the new MUC Light.
There may be various reasons to do so: using a familiar protocol,
avoiding additional implementation, quick prototyping etc.
This section provides suggestions of mappings between XEP-0045 stanzas and the new ones described in this document.
These mappings are ONLY available to use in the legacy mode, which allows using a subset of classic MUC stanzas but comes with the drawback that some of the functions are limited.

Operations not described here SHOULD remain unmodified.

Expand Down

0 comments on commit dbb1cd4

Please sign in to comment.