helix icon indicating copy to clipboard operation
helix copied to clipboard

docs: Punctuation on tutor

Open adrian5 opened this issue 3 years ago • 6 comments
trafficstars

Correctness aside, “the line below marked” reads oddly, and makes one assume “below --->” for a second.

adrian5 avatar Sep 18 '22 14:09 adrian5

I'm not sure this is more correct and the current text reads better to me. Can you explain?

My grammar is a bit rusty but the way I see it, the sentence breaks down like so

Move the cursor to the line below [which/that is] marked '-->'
|--|     |----| |---------------| |--------------------------|
Verb      Noun     Preposition      Defining Relative Clause

And I think it's a common blunder to use a comma to connect a defining relative clause - though it would be correct for a non-defining relative clause. (And it's defining because you need the information that the line is marked with the "-->" to know which line the sentence is referring to.)

the-mikedavis avatar Sep 18 '22 15:09 the-mikedavis

@the-mikedavis Your grammar is good, there is no need for a defining relative clause or comma, I think it sounds correct as well as being correct.

David-Else avatar Sep 18 '22 16:09 David-Else

I think it sounds correct

Well, in speech one would make a pause after below, to differentiate:

Move the cursor to the line below [which is] marked '-->'
Move the cursor to the line below [the] marked items

I'm not a native speaker, but to me that reads better with a comma. Feel free to close if you disagree, I may be wrong.

adrian5 avatar Sep 19 '22 09:09 adrian5

Even though there may be a slight pause in speech, it is grammatically incorrect to have a comma.

kirawi avatar Sep 20 '22 23:09 kirawi

It might be clearer to use "Move the cursor to the line marked '-->' below". What do you think?

the-mikedavis avatar Sep 21 '22 01:09 the-mikedavis

That's clearer in my view. The marked '-->' is what's important (to look for), and below is only added to ensure the user goes looking in the right direction.

adrian5 avatar Sep 21 '22 21:09 adrian5

Thanks!

the-mikedavis avatar Sep 23 '22 17:09 the-mikedavis