Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Context sensitive help #3563

Merged
merged 1 commit into from
Aug 3, 2022
Merged

Context sensitive help #3563

merged 1 commit into from
Aug 3, 2022

Conversation

HebaruSan
Copy link
Member

Motivation

We had somebody stop by the Discord asking how to use the Manage Game Instances popup, which appears by itself, blank, if you have no game instances and CKAN can't find one in Steam.

We added some help menu options in #3437, but these not accessible from the Manage Game Instances popup. (And that pull request's changes have not been released yet.)

Changes

  • Now .HelpButton is true for most of our popup dialogs
  • Now .MinimizeBox and .MaximizeBox are false for Manage Game Instances and Install Filters, which they probably should have been anyway because maximizing and minimizing these popups is not useful
  • Now we override OnHelpButtonClicked and OnHelpRequested to open the most relevant help page for each context (the user guide by default, more specific links such as PRs when available)

Now to access help, users will be able to press F1 anywhere or click this question mark button for most of our popups:

image

(Note that this button is not added to the main form because it is mutually exclusive with the minimize and maximize buttons, which we should keep for the main form.)

This should allow some users to find help on their own, and it will simplify many support requests down to telling users, "You can press F1 for help on that".

@HebaruSan HebaruSan added Enhancement New features or functionality Easy This is easy to fix GUI Issues affecting the interactive GUI Pull request labels Apr 13, 2022
Copy link
Member

@techman83 techman83 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

My only comment would be here, that we might want to centralise these URLs as constants somewhere. Digging through the code base if we had a to change a bunch of URLs would make for a maintenance burden (though I appreciate we probably already have this burden.)

@HebaruSan
Copy link
Member Author

HebaruSan commented Aug 3, 2022

Good idea, moved them to a new HelpURLs file/class. Also updated some existing links to the user guide and Discord.

... and moved HelpURLs to Core so we can replace two even older wiki links.

@HebaruSan HebaruSan merged commit 9b852eb into KSP-CKAN:master Aug 3, 2022
@HebaruSan HebaruSan deleted the feature/help branch August 3, 2022 12:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Easy This is easy to fix Enhancement New features or functionality GUI Issues affecting the interactive GUI
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants