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

Add Document Switcher docs to new "User Interface" page #629

Merged
merged 11 commits into from
Feb 5, 2024

Conversation

pryrt
Copy link
Contributor

@pryrt pryrt commented Feb 4, 2024

closes #628

Also moved the sections under Cheat Sheet into the new User Interface page instead (leaving a link from Other Resources > Cheat Sheet to the new page)

@alankilborn
Copy link

Generally, I don't like the "selected" terminology, along with parenthetical explanation of it pretty much each time.
Would it be better to call it "pre-selected" (that's what it truly is) and define it once at the top, and then use that term over and over later (without the explanation) each time?

@pryrt
Copy link
Contributor Author

pryrt commented Feb 4, 2024

Generally, I don't like the ... parenthetical explanation of it pretty much each time.

I didn't like the parenthetical either. Your original description focused on the bolding, so I wasn't sure if you thought there would be ambiguity to the reader, so I left it there, though I shouldn't've.

I don't like the "selected" terminology

I assume that's because it implies to you that the referenced tab is actually "selected", with the follow-on incorrect implication that the tab was immediately activated. I was trying to draw a distinction between "selecting" in the Document Switcher and the final "activation" of the "selected" tab when the Document Switcher was terminated. (For a similar distinguishing between "selected" and the final action, in the Plugins Admin interface, you can "select" a Plugin without installing it, and even select it without checkmarking it to put in the queue for installation -- so making a selection and using that selection are two separate things in GUI controls.)

But I can definitely see why you don't like it, because I am sure you aren't the only user who would interpret "select" that way, despite my pedantic usage.

Would it be better to call it "pre-selected"

I like that even less: I think there are fewer users who would understand that correctly -- I think the first interpretation of that phrase would likely be that it would be a term reserved for whichever tab name is in bold when the popup first opens, and continued use throughout the description would serve to confuse, rather than properly describe.

I am now seeing why you just went with "bold" in your original description. If I can phrase it in a way I like, I'll probably go back to that idea (or something similar).

…d' to avoid confusing terminology, and to get rid of the bold-parentheticals

(also fixed some spelling mistakes)
@@ -116,6 +116,6 @@ When cycling through the tabs in the Document Switcher, if the bottom entry in t

If you hold down <kbd>Shift</kbd> (while still holding the <kbd>Ctrl</kbd> key to keep you in Document Switcher mode), and then press and release the <kbd>Tab</kbd>, it will cause the selection (bold highlight) to move to the previous entry in the tab list, rather than the next. (And in the long-list scenario, it would scroll to the next tab above the top in the list, making that visible and scrolling the bottom tab in the list out of the visible popup.)

The Document Switcher functionality can also be achieved using just the mouse (if you have a scroll wheel): Right-click in the editing area for a tab and hold the right mouse button, then begin scrolling the mouse wheel (in either direction) to display the Document Switcher popup; further scrolling of the scroll wheel will change which tab is selected in the list. Releasing the right mouse button will cause the currently-selected tab to be activated.
The Document Switcher functionality can also be achieved using just the mouse (if you have a scroll wheel): Right-click in the editing area for a tab and hold the right mouse button, then begin scrolling the mouse wheel (in either direction) to display the Document Switcher popup; further scrolling of the scroll wheel will change which tab is selected in the list. Releasing the right mouse button will cause the currently-selected tab to be activated. An alternate way to activate a tab using the mouse, while the right mouse button is still held and the Document Switcher is displayd, is to left-click on one of the tab names from the list, which will immediately make that entry bold, activate the tab, and close the popup (even though you haven't let go of the right mouse button yet).

Choose a reason for hiding this comment

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

typo: displayd

Copy link
Contributor Author

Choose a reason for hiding this comment

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

That was already fixed in 9f9a537 , along with many other typos (hence the (also fixed some spelling mistakes) in that commit message)

@pryrt pryrt merged commit 3a21db3 into notepad-plus-plus:master Feb 5, 2024
1 check passed
pryrt added a commit that referenced this pull request Feb 5, 2024
pryrt added a commit that referenced this pull request Feb 5, 2024
@pryrt pryrt deleted the userInterface branch February 5, 2024 20:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Improve Document Switcher documentation
2 participants