Fixing Typos Awkward Wording and Poor Grammar of Problems

Back to General discussions forum

Trey Shaffer     2015-07-27 02:28:30
User avatar

I frequently find awkward wording, and errors in spelling and grammar in problem descriptions. Although it's not a big deal, an improvement in problem fluency couldn't hurt as it would improve the site's credibility.

For example, Problem #122 (QuickSort):

After you have learned about three sort algorithms with quadratic time complexion (Bubble-, Selection and Insertion sorts) you should be curious, whether it is possible to perform the task significantly faster.

could be changed to

Now that you have learned about three sorting algorithms with quadratic time complexity (Bubble, Selection, and Insertion sort), you may be curious as to whether or not there are faster algorithms for sorting.

Rodion (admin)     2015-07-27 04:33:37
User avatar

Hi! Thanks for your message!

> Although it's not a big deal, an improvement in problem fluency couldn't hurt as it would improve the site's credibility.

Actually, this is a big deal as surely this makes the site looking even more clumsy and poor - and surely sometimes this even may lead to misreading of statements :(

As you know English is not my native language, so initially I thought that after creating "first version" of statements, native-English users will by and by help with proof-reading, but you see - this process is not very fast...

Thanks a lot - I've changed the fragment in the task about QuickSort to one proposed by you!

Please, feel free to write about any phrases looking too horrible! This will help a lot!

UPD I've created a separate project in github where suggestions could be left as "issues", since probably it is not always convenient to cooperate via forum. Instructions on supposed workflow are included :)

Guy Gervais     2015-07-27 12:41:28
User avatar

The process for corrections is a lot of work... would some type of "wiki" solution be possible? Ideally, if we could click "Edit" and then directly modify the page, it would be much easier to do the corrections; often it's a very simple type or a missing word. The corrections could be queue for review before being published (to prevent vandalism), or require "votes" from some pre-approved members, etc.

Guy Gervais     2015-07-27 13:17:53
User avatar

Ah! I wrote "very simple type" instead of "very simple typo". Nice.

Rodion (admin)     2015-07-27 13:51:51
User avatar

Hi Guy!

>would some type of "wiki" solution be possible?

Well, here is a typical "tradeof" - the more advanced and complicated feature - the more efforts it will take to implement. At very beginning there was a feature like "Select - Ctrl-Enter - and suggest improvement", however later I removed it since it was used rarely enough and often people did not make themselves clear enough (and surely it is inconvenient for them that they could not review their suggestions).

I'll try to think a bit how your idea could be implemented so that it is both not too complicated but yet functional...

OldProgrammer     2015-07-27 22:43:19

I too have noticed a few minor spelling and grammar issues. IMO, they don't at all reflect badly on this site or on you. The standard of writing in terms of the sophistication of the concepts it deals with, and the clarity with which it does is better than many native English speakers would manage.

I would love to be able to comprehend and write other languages as well as you (and non-English speakers in general here) do.

However, if I notice anything again, I'll try to remember to bring it to your notice.

OldProgrammer     2015-08-03 15:39:23

Problem #55 (Matching Words) has spelling mistake "fourty". It should be "forty".

Also in the sentence "You are to help the poor craftsmen to access the thieve's treasury." should be rewritten as "You are to help the poor craftsman to access the thieves' treasury.".

There is one craftsman (Ali Baba) and "thieves" is a plural so apostrophe comes after the ending "s".

"Write a program which sieves necessary words... " is better as "Write a program that sieves necessary words...".

"The end is signalized by the word" should be "The end is signaled by the word".

"Note: though for small amount of words...to compare each-to-each, this approach is inefficient for larger" is better as "Note: although for small amount of words...to compare words, this approach is inefficient for large numbers of words"

OldProgrammer     2015-08-03 15:55:04

For Problem #47 (Caesar Shift Cipher) change the initial sentences from:

"Cryptography is one of most interesting branches of programming. Studying its algorithms is usually started with the simple method named after famous Roman imperor Julius Caesar who used it for communicating his military secrets (and perhaps for love letters to Cleopatra).

We will practice in deciphering an encrypted messages in this problem."

to:

"Cryptography is one of most interesting branches of programming. Studying its algorithms usually begins with the simple method named after famous Roman emperor Julius Caesar who used it for communicating military secrets (and perhaps for love letters to Cleopatra).

We will practice deciphering encrypted messages in this problem."

Rodion (admin)     2015-08-03 16:10:28
User avatar

Wow! Thanks a lot! I've tried to fix all these mistakes - the one with "thief and craftsmen" really made me laugh! Though I'm afraid it is not very pleasant for visitors to read such silly errors :)

OldProgrammer     2015-08-24 01:15:28

Problem 182 - Frodo and Black Riders

"The idea of this problem was hinted by Laurent Petit ..." should be something more like "Laurent Petit suggested this problem...".

In "In the 1-st part of Lord of the Rings", "1-st" should be "first" or "1st".

"and several Black Riders are placed over it" reads better as "with several Black Riders in it".

"Each of Black Rider have limited field of view, as shown on a picture above." reads better as "Each Black Rider has a limited field of view, as shown in the picture above.".

"Of course he can see further straight before him and have quite limited perception..." reads better as "Of course he can see futhest straight ahead, but has limited perception...".

"The bound of this field of view is described by simple equation in polar coordinates: ... Where" is better as "The boundary of this field of view is described by simple equation in polar coordinates: ... where".

"the direction at which the Rider is currently faced." is better as "the direction in which the Rider is currently facing."

"and you need not care if the sum is not exactly" is better as "and you need not worry if the sum is not exactly".

Finally, typo "guarede" should be "guarded".

Rodion (admin)     2015-08-26 09:08:58
User avatar

Thank you very much! I've just tried to apply these suggestions. Sometimes I myself wonder how I could write so clumsily :)

OldProgrammer     2015-08-26 22:23:02

You're welcome! Your writing does an excellent job of communicating problem concepts and specifications.

Now for corrections to my suggestions:

1) "with several Black Riders in it" reads better as "and several Black Riders in it." because there is an earlier "with" in the sentence.

2) Incorrect spelling "futhest" should be "furthest".

Please login and solve 5 problems to be able to post at forum