Making help files more helpful

MUSH help systems are generally pretty… unhelpful.

Traditional MU* help has been based around a screen of disjointed topics, each containing command syntax with very little context about when and why you should use said commands. They assume you already know what everything does and just need a quick lookup for syntax.

------------------------------------------------------------------------------- 
                                    +help Topics                                 
   
+BG                       +FINGER                   +DESC
+HELP                     +LIST                     +MAIL
   
See +help  for more information about a topic.
 -------------------------------------------------------------------------------

Ares’ current help system attempts to improve on that with topic-based help.

+==~~~~~====~~~~====~~~~====~~~~=====~~~~=====~~~~====~~~~====~~~~====~~~~~==+
1 - Getting Started
     Help - Getting help.
     Login - Logging in and managing your connection.
     Roles - Game admin and command permissions.
     Help Pages - Multi-page commands.
Channels
     Channels - Public chat channels.
     Channels Admin - Managing channels.
     Channels Talk - Talking on channels.
     Channels Utils - Advanced channel commands.
+==~~~~~====~~~~====~~~~====~~~~=====~~~~=====~~~~====~~~~====~~~~====~~~~~==+

But it’s still not great. Is the command you want under help channels talk or help channels utils? Plus you get spammed with a whole screen of text when really all you want is the syntax for bbreply. It’s annoying.

Ideally I think it would be good to split up the “tutorial” aspect from the “command quick reference” aspect, but I haven’t quite worked out the nuts and bolts of how to do that. Open to suggestions.