Re: [PATCH v3] btrfs-progs: Doc: Add warning and note on btrfs-convert.

[Duncan <1i5t5.duncan@cox.net>]

Qu Wenruo posted on Fri, 03 Apr 2015 15:06:46 +0800 as excerpted:

> It seems my English is really poor... :(

I think the usual response is "Better than my Chinese!" =:^)

Seriously, tho, it's better than many native English speakers/writers as 
well, good enough I'd not guess different were it not for the name and 
the cn hint in your email address.  Meanwhile, while it was a sentence 
fragment, in less formal settings (such as this list) it would have 
passed more or less unnoticed, particularly since the meaning was so 
obvious that not even a word needed changed, only a bit of punctuation.

In more formal setting such as btrfs documentation, however, a sentence 
fragment of that sort will trigger the reader's misparse detector, thus 
causing them to pause and go back and reread, slower, to see where their 
natural parsing went wrong.  As such, it brings attention to something 
that would otherwise be fairly minor.  So better to fix it now and not 
have all those people stumbling over it later. =:^)

-- 
Duncan - List replies preferred.   No HTML msgs.
"Every nonfree program has a lord, a master --
and if you use the program, he is your master."  Richard Stallman