Details
-
Task
-
Resolution: Unresolved
-
P3: Somewhat important
-
None
-
Qt Creator 13.0.0-beta1
-
None
Description
Some conventions used in the Qt Creator Manual and Qt Design Studio Manual predate the decision to start following and enforcing the Microsoft Style Guide. This topic lists the found deviations:
| Current | MS Style Guide | Link |
|---|---|---|
| (you) can | Rewrite to leave out, unless it is about the ability to do something (not the possibility) | https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/c/can-may |
| directory/folder | folder (except "in content for developers when you need to refer to the structure of the file system or to match the API") | https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/d/directory |
| drag-and-drop | drag | https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/d/drag-and-drop |
| deselect check box | clear checkbox | https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/c/check-checkbox-check-mark |
| field (for everything, except checkboxes and sometimes lists) | Leave out or use "box" or "checkbox" if really needed | https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/f/field |
| select (for everything except plugins) | go to (for menu items, tabs, views and other locations, and websites) | https://learn.microsoft.com/en-us/style-guide/procedures-instructions/describing-interactions-with-ui |
| development PC, machine, host | computer (with lots of exceptions) | https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/computer-device-terms |
| enable/disable | Turn on/off | https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/e/enable-enables https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/d/disable-disabled |
| specify | select (or any other verb that is accurate for the case) | https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/s/set-specify |