lSwitcher Naming Standards

version 2017102101

This should end up in the lSwitcher wiki.

Program name:

lSwitcher

The initial letter is lowercase, and "Switcher" appears in proper case. This is in deference to the original author, Andrei Los, and should not be changed.

Specific terms:

Popup               - PM popup window
List                - text mode task list
Taskbar             - standalone taskbar
Widget              - XCenter widget
Properties notebook - program settings notebook
Hotkeys             - list of valid hotkeys for the application

As these terms denote modes specific to lSwitcher, they should appear in proper case.

Common terms:

tooltip             - floating text (bubble) associated with task icon
hotkey              - mnemonic also capable of use when menu is not accessible
hotkey combination  - two or more hotkeys which trigger an unique action
activation hotkey
combination         - specific hotkey combination which triggers Popup or List
fullscreen          - command session; should not be appreviated
mouse button #      - button assigned to mouse button 1, 2, or 3
task                - window, program, or session; also used for "item" in context
selection box       - rectangle surrounding the focused task in the Popup 

As these terms are more generic in nature, they should appear in lower case unless at the beginning of a sentence.

Acronyms:

PM                  - Presentation Manager
WPS                 - Workplace Shell

These terms should be well known to any OS/2 user capable of installing the application. No need to write these out.

Menu conventions:

Properties           - program settings notebook

Note proper case and no elipsis.

Properties:

Alt+Tab              - activation hotkey combination
Ctrl+Tab             - alternative activation hotkey combination
Sticky Mode          - Popup stays on screen
Auto-hide Mode       - Taskbar disappears when not focused
Button #             - button assigned to mouse button 1, 2, or 3
Z-order              - foreground/background ordering of tasks
OS/2 Window List     - OS/2 differentiates this from the lSwitcher List
Task Group           - related tasks, grouped together

Note capitalization (usually proper case).

Properties notebook:

Major tab text should be single word, or if multiple words are necessary, these should be in proper case.
Minor tab text should be single word (General, Mouse, Exclusions) in proper text. If multiple words are necessary, these should be in proper case.
Pages should be numbered as Page # of #, where "Page" is in proper case.
Major sections of a given page should be appropriately labeled in proper case.
Buttons and checkboxes should use Proper case, and where two or more words are necessary, successive words should be lower case, e.g., Remove entry.

Help:

bold                  - lSwitcher, section titles, filenames, properties, specific terms,
                        command line switches, special characters (? *)
italics               - keys, option names in Properties, emphasis, parentheticals
<>                    - surrounds user-entered data