Fossil SCM
Added a description of the user activity list to www/chat.md.
Commit
d046ab687d028c9072909a11fb0c15c7ab2dacb4bca93f0d7a7d8d0fcf01ff91
Parent
a4b9af1bb059cd9…
1 file changed
+24
+24
| --- www/chat.md | ||
| +++ www/chat.md | ||
| @@ -96,10 +96,34 @@ | ||
| 96 | 96 | By default, the list of new-message notification sounds is limited to |
| 97 | 97 | a few built in to the fossil binary. In addition, any |
| 98 | 98 | [unversioned files](./unvers.wiki) named `alert-sounds/*.{mp3,wav,ogg}` |
| 99 | 99 | will be included in that list. To switch sounds, tap the "settings" |
| 100 | 100 | button. |
| 101 | + | |
| 102 | +### <a id='connection'></a> Who's Online? | |
| 103 | + | |
| 104 | +Because the chat app has to be able to work over transient CGI-based | |
| 105 | +connections, as opposed to a stable socket connection to the server, | |
| 106 | +real-time tracking of "who's online" is not possible. As of version | |
| 107 | +2.17, chat offers an optional feature, toggleable in the settings, | |
| 108 | +which can list users who have posted messages in the client's current | |
| 109 | +list of loaded messages. This is not the same thing as tracking who's | |
| 110 | +online, but it gives an overview of which users have been active most | |
| 111 | +recently, noting that "lurkers" (people who post no messages) will not | |
| 112 | +show up in that list, nor does the chat infrastructure have a way to | |
| 113 | +track and present those. That list can be used to filter messages on a | |
| 114 | +specific user by tapping on that user's name, tapping a second time to | |
| 115 | +remove the filter. | |
| 116 | + | |
| 117 | +Sidebar: message deletion is a type of message and deletions count | |
| 118 | +towards updates in the recent activity list (counted for the person | |
| 119 | +who performed the deletion, nor the author of the deleted | |
| 120 | +comment). That can potentially lead to odd corner cases where a user | |
| 121 | +shows up in the list but has no messages which are currently visible | |
| 122 | +because they were deleted. That is a known minor cosmetic-only bug | |
| 123 | +with a resolution of "will not fix." | |
| 124 | + | |
| 101 | 125 | |
| 102 | 126 | ## Implementation Details |
| 103 | 127 | |
| 104 | 128 | *You do not need to understand how Fossil chat works in order to use it. |
| 105 | 129 | But many developers prefer to know how their tools work. |
| 106 | 130 |
| --- www/chat.md | |
| +++ www/chat.md | |
| @@ -96,10 +96,34 @@ | |
| 96 | By default, the list of new-message notification sounds is limited to |
| 97 | a few built in to the fossil binary. In addition, any |
| 98 | [unversioned files](./unvers.wiki) named `alert-sounds/*.{mp3,wav,ogg}` |
| 99 | will be included in that list. To switch sounds, tap the "settings" |
| 100 | button. |
| 101 | |
| 102 | ## Implementation Details |
| 103 | |
| 104 | *You do not need to understand how Fossil chat works in order to use it. |
| 105 | But many developers prefer to know how their tools work. |
| 106 |
| --- www/chat.md | |
| +++ www/chat.md | |
| @@ -96,10 +96,34 @@ | |
| 96 | By default, the list of new-message notification sounds is limited to |
| 97 | a few built in to the fossil binary. In addition, any |
| 98 | [unversioned files](./unvers.wiki) named `alert-sounds/*.{mp3,wav,ogg}` |
| 99 | will be included in that list. To switch sounds, tap the "settings" |
| 100 | button. |
| 101 | |
| 102 | ### <a id='connection'></a> Who's Online? |
| 103 | |
| 104 | Because the chat app has to be able to work over transient CGI-based |
| 105 | connections, as opposed to a stable socket connection to the server, |
| 106 | real-time tracking of "who's online" is not possible. As of version |
| 107 | 2.17, chat offers an optional feature, toggleable in the settings, |
| 108 | which can list users who have posted messages in the client's current |
| 109 | list of loaded messages. This is not the same thing as tracking who's |
| 110 | online, but it gives an overview of which users have been active most |
| 111 | recently, noting that "lurkers" (people who post no messages) will not |
| 112 | show up in that list, nor does the chat infrastructure have a way to |
| 113 | track and present those. That list can be used to filter messages on a |
| 114 | specific user by tapping on that user's name, tapping a second time to |
| 115 | remove the filter. |
| 116 | |
| 117 | Sidebar: message deletion is a type of message and deletions count |
| 118 | towards updates in the recent activity list (counted for the person |
| 119 | who performed the deletion, nor the author of the deleted |
| 120 | comment). That can potentially lead to odd corner cases where a user |
| 121 | shows up in the list but has no messages which are currently visible |
| 122 | because they were deleted. That is a known minor cosmetic-only bug |
| 123 | with a resolution of "will not fix." |
| 124 | |
| 125 | |
| 126 | ## Implementation Details |
| 127 | |
| 128 | *You do not need to understand how Fossil chat works in order to use it. |
| 129 | But many developers prefer to know how their tools work. |
| 130 |