adjusting this complex sentence

Share your ideas as to how the documentation can be improved.
billio
Posts: 7
Joined: 30 Jun 2022, 11:18

adjusting this complex sentence

Post by billio » 10 Jul 2022, 23:12

https://www.autohotkey.com/docs/Language.htm#not-control-flow
"As directives, labels (including hotkeys and hotstrings), and declarations without assignments are processed when the script is loaded from file, they are not subject to control flow"

I suggest that complex sentence be written as these two sentences, it's then much clearer.

“Directives, labels (including hotkeys and hotstrings), and declarations without assignments, are all processed when the script is loaded from a file. As such, they are not subject to control flow.”

billio
Posts: 7
Joined: 30 Jun 2022, 11:18

Re: adjusting this complex sentence

Post by billio » 11 Jul 2022, 01:39

Or changing the first word from "As", to "Because". would make it so much clearer.

User avatar
Ragnar
Posts: 611
Joined: 30 Sep 2013, 15:25

Re: adjusting this complex sentence

Post by Ragnar » 11 Aug 2022, 14:38

Thanks for reporting, but I see no need to change this sentence. Personally, I find it completely understandable.

Post Reply

Return to “Suggestions on Documentation Improvements”