From e9298ce3c34e864f96295ba0447b300581914307 Mon Sep 17 00:00:00 2001 From: Maze Date: Sat, 29 Jan 2022 15:44:42 +0100 Subject: [PATCH] Add POWERUSER.md --- docs/POWERUSER.md | 52 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 52 insertions(+) create mode 100644 docs/POWERUSER.md diff --git a/docs/POWERUSER.md b/docs/POWERUSER.md new file mode 100644 index 00000000..798a112e --- /dev/null +++ b/docs/POWERUSER.md @@ -0,0 +1,52 @@ +# A power user's guide to Moment + +This page describes the intended way to navigate Moment to reach its full +potential. +It is intended for users who participate in hundrends of chat rooms and are +active in many conversations at once. + +## Jumping to received messages + +If you receive a lot of messages that you would like to respond to, you may +find it tedious to keep clicking on the room list. A quicker way is to press +Ctrl+U to jump to the latest unread room. + +## Jumping to recently visited chats + +When you are active in many rooms at once, it can be useful to switch between +them quickly without needing to think which is which. For this purpose, Moment +remembers recently visited rooms, and you can quickly navigate through the +history using Ctrl+H and Ctrl+L. If you are struggling to +keep up with many ongoing conversations, we recommend utilizing this history as +much as possible. + +## Jumping to specific rooms + +You can use Ctrl+K to search for a room and switch to it. However, +you may find that you keep searching for the same rooms again and again. There +is a faster way which does not require typing out the name of a room: setting +some custom keybindings for jumping to specific rooms. + +For example, if you often talk in `#moment-client:matrix.org`, you may want to +set a custom binding Ctrl+G Ctrl+M for it. Right-click on it in the +room list and select "Copy room ID". Add the following entry to your +[config file](CONFIG.md): + +``` python +class Keys: + class Rooms: + class Direct: + "!wweZtVjpQSdWDDruas:mazie.rocks" = ["Ctrl+G,Ctrl+M"] +``` +Where `!wweZtVjpQSdWDDruas:mazie.rocks` is the id for +`#moment-client:matrix.org` in this example. + +Unlike using Ctrl+K, this approach is independent of room name +changes. For example, when another user changes their display name, the DM room +name would change, but not the ID, so the keybinding remains functional. + +We suggest setting memorable keybindings. In the above example, +Ctrl+G Ctrl+M could mean "Go to Moment". Note that key chords in +Moment can be as long as you want - for example, you could have +Ctrl+G Ctrl+M Ctrl+O for `#moment-client:matrix.org` and +Ctrl+G Ctrl+M Ctrl+I for `#mirage-client:matrix.org`.