Как улучшить английский в документации. Часть 2: ловушки двусмысленности

[ivankudryavtsev]

Меня люто парит, когда калькой с русского выбирают английское слово, типа possibility вместо capability :)

Ну и вообще любая склонность автора к общим, неспецифическим словам, особенно глаголам.

[kozlyuk]

✅ If an error occurred while you are updating a config file, the operating system might be able to recover the file.

Можно ли сделать это предложение ещё лучше? Напишите в комментариях.

If you encountered an error while updating a config file, ...

If an error occurred during a config file update, ...

[iggr63]

If an error occurred while updating a config file, ...

[makushevkm]

С этого ошибочного варианта мы и начали блок :)

[iggr63]

Ай-яй-яй. Посмотрел. Двойка за невнимательность. Я попытался написать требование по INCOSE.