[patch] Documentation updates

[BerndA]

Hi again,
This is another patch changing only documentation/readme.

Description:
- typo corrections in comments and readme
- @returns --> @return
- documentation translation

Regards,
Bernd

[IgorEliezer]

Translations are most welcome. Considering the fact Prissi is looking for more help.

[BerndA]

Translations are most welcome.

Thanks for your feedback. Does this include translation of code fragments, too? For example, variables, function names, ...

[IgorEliezer]

Does this include translation of code fragments, too? For example, variables, function names, ...

Yes. One of obstacles for new coders has been "non-English" parts in the code. This is not a big problem; with a bit of effort, any coder will understand such parts.

But, before doing something real, ask Prissi first (or, let him answer with a "OK"), once translating parts of code is critical and there are "rules" to follow.