Well, for a start, this....
"You can resize the height of attached view or dictionary view by while
selected ctrl key and rotate the mouse wheel." is appalling English!
The words 'by' and 'while' have absolutely no right being next to each
other.
It should read something like "You can resize the height of attached view
or dictionary view by holding down the Ctrl key and rotating the mouse
wheel."
Just my thoughts.
As for the rest of the terminology on the Microsoft page, I have no issue.
But even that page does not specify a use-case for Ctrl+click. But I think
we've had this discussion already, didn't we?
That there should be no spaces (i.e. Ctrl + click would be incorrect), and
that the modifier key (Ctrl) SHOULD be capitalized.
Cheers,
Bruce Williams
------------------------------
Mobile:  +61 41 250 6349

audio2u.com
brucewilliamsphotography.com
shuttersincpodcast.com
sinelanguagepodcast.com

e-mail <stu...@audio2u.com> | Twitter <http://twitter.com/@audio2u> |
LinkedIn <http://au.linkedin.com/pub/bruce-williams/1/318/489> | Facebook
<http://www.facebook.com/audio2u> | Soundcloud
<http://www.soundcloud.com/audio2u> | Quora
<https://www.quora.com/profile/Bruce-Williams-5>
------------------------------




---------- Forwarded message ---------
From: openhab.doc <openhab....@web.de>
Date: Thu, Sep 26, 2019 at 4:30 PM
Subject: [darktable-dev] Standardization of the writing of mouse
interactions in the user manual
To: <darktable-dev@lists.darktable.org>


Hello developer and documentation team,



Since the keyboard shortcuts are now standardized in the user manual [1],
the writing of the mouse interactions should also be standardized.



For example, the following spellings can be found in the manual:



Ctrl+click, Ctrl+clicking,

right click, right-click and click right

Ctrl+wheel, Ctrl+scroll



The first step is to agree the writing style in the team.



Based on the Microsoft recommendations (
https://docs.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/mouse-mouse-interaction-terms
) the following example sentence can be changed:



Original from user manual:

You can resize the height of attached view or dictionary view using
Ctrl+wheel.



Example for a possible change:

You can resize the height of attached view or dictionary view by while
selected ctrl key and rotate the mouse wheel.



Feel free to discuss this topic and make many suggestions!



PS: I'm to a native speaker!



Pierre Metzner



[1] https://github.com/darktable-org/darktable/issues/2963

[2]
https://docs.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/term-collections/mouse-mouse-interaction-terms

___________________________________________________________________________
darktable developer mailing list to unsubscribe send a mail to
darktable-dev+unsubscr...@lists.darktable.org

___________________________________________________________________________
darktable developer mailing list
to unsubscribe send a mail to darktable-dev+unsubscr...@lists.darktable.org

Reply via email to