GP SoftwareTwitter
Opus FAQsManualCommandsObjects

Main DO website & manual feedback

Since these forums are the primary way new users can learn how to get the most out of DO, I suggest that you make a direct link to them under the main page "Support" button (rather than the two-clicks currently needed). I also suggest that you call that menu item "Help" or "Forums" because to many people the phrase "technical support" implies trying to fix bugs or crashes rather than simply trying to figure out how to best use a product that is otherwise working correctly. I often have to pause for a second to figure out how to get here from the main page.

Also, as a new and enthusiastic DO user without much technical know-how, I also have feedback on the documentation. Are the developers interested in hearing it? Where is the appropriate place to post it?

1 Like

You can post documentation feedback here. We're always glad to know people are actually reading the manual! :smiley:

OK. FYI, I'm more likely to provide feedback if you comment on whether you agree/disagree with my suggestions (like the one about the Support menu) so I know what's worth spending time on.

I just took some notes as I'm trying to learn the program and here are three thoughts:

  1. It was hard to find a full list of keyboard shortcuts/hotkeys. I found it under a tab that says "keys" but that is not a standard label for these items. I recommend creating an item in the manual that can be located by searching for either shortcut or hotkey.
  2. When changing hotkeys, you are supposed to press a green circle with check in it to confirm the change. This is a very nonstandard way / icon to indicate "confirmed change". Most programs use a button with the word "apply". Usually green and check mean something like "acceptable" or "okay" and I initially assumed that the green check would change to something else (like a red X) if I tried to enter something where there was a conflict with another keyboard shortcut. Further, when I hit "OK" on the window, I assumed my keyboard shortcut change was accepted (that usually applies any changes made) and I was confused when it didn't work. I recommend that if you make changes in this window and someone hits "OK" without saving it that you pop up a dialog box asking whether they want to discard changes, which again is very standard.
  3. I was trying to figure out how to create my own buttons. I was excited when I found a page in the help file labeled "creating your own buttons." Unfortunately, this page does not actually tell you how to create your own buttons – it merely gives tips and points you to other resources. I only figured out how to create my own buttons semi-randomly by reading the forums.

A list of hotkeys can be found in the program itself, and will reflect customizations you've done which the manual couldn't show.

Help > Keyboard Map is a quick way to get to it.

That's to protect against accidentally trashing the hotkeys. It's only in the full list of hotkeys, and not when editing individual hotkeys/commands (e.g. double-click an item in that list).

We could improve the UI there though, definitely. Adding labels to those buttons is something I have planned, and we might be able to make it so the button doesn't appear until a change is made, which makes it more obvious it needs to be clicked.

That page is the start of a whole section in the manual. Expand the branch for a lot more documentation on different aspects of creating buttons:

If you aren't viewing the "Contents" tab to see that the section can be expanded and has sub-pages, they are also listed at the bottom of the page itself:

I've made some slight changes to the manual which add a few words/sentences that may help a little with some of the above. (Unfortunately, we don't have a lot of control over what the Search tab in the manual finds for individual phrases, but I've clarified things like the button editing page being the first of a large section.)

1 Like

Glad to see the comments were useful. Re: hotkeys, you write:

I knew that a list of hotkeys can be found in the program, and I was able to eventually find them myself, but it was difficult. Since the keyboard map is not a list of all keys but a list of hotkeys, why not label the "Keys" tab as "Hotkeys" or "Keyboard shortcuts"? Putting those words in the manual will also allow a user to find them by searching. I would have never guessed to search for "keyboard map" to find what I think of as hotkeys.

Just FYI, teachers sometimes talk about "the curse of knowledge", which is a way of referring to the fact that once you know something very well, it's hard to imagine how someone that doesn't know it thinks about it or could be confused by it. I assume that most of the things that confuse me actually have explanations in the manual, it's just that I have no idea how to locate them in the manual. I'm mostly trying to give you feedback to help you understand how someone that does not know this program yet can get lost or misunderstand things to give you an opportunity to prevent confusion for future novice users.

1 Like

Originally it was labelled "Hotkeys", but people complained that they didn't know what the term "hotkeys" meant.

I see. Maybe "Keyboard Shortcuts" would be clearer? Even if people don't ask what "keys" means, the problem is that no one ever searching for keyboard shortcuts would try to find them by searching for "keys" in the manual. The rename avoided the problem of people not knowing what "hotkeys" means, but created the less visible problem of people who do know not being able to find out how to see the list of hotkeys/shortcuts!

If you search for "hotkeys" in the manual the page on that tab is the first result that comes up.

You're right! Maybe I searched for "shortcuts" but forgot to search for hotkeys. I gotta tell you though, when I looked at the "keys" page in the manual, I read the first sentence and my first thought was, "Where on Earth do I go to customize the keys page in DO?" Now that I have used DO for a few weeks and have learned more about the manual, I realize I can look above to see the breadcrumbs bar or the contents pane to see where the manual page is in the overall structure of the instructions, and then can figure out how to find that in DO. But it's not obvious to me (and probably some others). I guess I'm just giving you some feedback from a novice that it actually requires some training to even figure out how to use the manual. I hope you don't take this is contentious; I actually like DO a lot but if I was not very highly motivated to use it I probably would have given up on trying to figure out how to customize it earlier. Just trying to help you guys succeed in attracting more novice users.

I guess people just aren't used to having manuals at all these days :grin:

1 Like