12-09-2022, 02:35 PM
(This post was last modified: 05-27-2023, 02:11 PM by github_bot. Edited 4 times in total.)
PULL REQUEST DETAILS
About the PR
This lets atoms define `help_message` which is analogous to `desc` except it's displayed when you alt+doubleclick a thing. This is intended to give short instructions on how to interact with a thing (i.e. what tool does what).
This is also available by right-clicking a thing and selecting *Help*, this is only present on items which actually have a help message. Clicking the Help verb in the Command tab or typing Help into the command bar shows you both instructions on how to use it and also a general message informing you about the wiki guide and F1 / F3. I consider this to be a good idea considering that a brand new player might type `help` into the command bar or click the (somewhat non-obvious) Help button in the verbs list. (I tried to make the verb name be bold there but no luck.)
As an example this PR implements the help message for disposal pipes. The expectation is that subsequent PRs from the community or from me will add similar help messages to as many relevant objects as possible.
The help messages can also be dynamic (i.e. a project with several phases of construction can show a different message based on what phase it is in).
Example of the help messages when alt+doubleclicking:
The base help message you get when you just click Help:
Right click menu option (only present if the object has a help message):
Light mode:
Why's this needed?
Many interactions are somewhat obscure, nonintuitive and hard to remember not only for new players but also for seasoned veterans. Whether it's deconstructing a reinforced wall (which has this sort of help already in its description) or building a custom vending machine or perhaps building a pod most players check the wiki which shouldn't generally be necessary in an ideal world. This is a step in that direction.
In addition to that this should also help with players adapting to the constant stream of new features for which even the wiki documentation tends to lag behind.
Changelog
PULL REQUEST DETAILS
About the PR
This lets atoms define `help_message` which is analogous to `desc` except it's displayed when you alt+doubleclick a thing. This is intended to give short instructions on how to interact with a thing (i.e. what tool does what).
This is also available by right-clicking a thing and selecting *Help*, this is only present on items which actually have a help message. Clicking the Help verb in the Command tab or typing Help into the command bar shows you both instructions on how to use it and also a general message informing you about the wiki guide and F1 / F3. I consider this to be a good idea considering that a brand new player might type `help` into the command bar or click the (somewhat non-obvious) Help button in the verbs list. (I tried to make the verb name be bold there but no luck.)
As an example this PR implements the help message for disposal pipes. The expectation is that subsequent PRs from the community or from me will add similar help messages to as many relevant objects as possible.
The help messages can also be dynamic (i.e. a project with several phases of construction can show a different message based on what phase it is in).
Example of the help messages when alt+doubleclicking:
The base help message you get when you just click Help:
Right click menu option (only present if the object has a help message):
Light mode:
Why's this needed?
Many interactions are somewhat obscure, nonintuitive and hard to remember not only for new players but also for seasoned veterans. Whether it's deconstructing a reinforced wall (which has this sort of help already in its description) or building a custom vending machine or perhaps building a pod most players check the wiki which shouldn't generally be necessary in an ideal world. This is a step in that direction.
In addition to that this should also help with players adapting to the constant stream of new features for which even the wiki documentation tends to lag behind.
Changelog
Code:
changelog
(u)pali
(*)You can now Alt+Doubleclick things to see a help message on how to use them. So far this is only implemented for a few things (disposal pipes) but expect this to be more widespread in the future. (Rightclick + clicking Help also works.)
PULL REQUEST DETAILS