Метаморфозы сознания. Про ревью и комментарии в технической документации

[dyadyaSerezha]

Вроде и есть что-то полезное тут для новичков (скорее, студентов) но сколько же воды! Даже джуны знают и понимают ценность и важность ревью.

Я когда прочел, сильно негодовал!

Не соблюден style guide. Не "я когда" (неформальное, разговорное), а "когда я".

Тщательнее ?

[pomponchik]

Даже лень пояснять, насколько плох этот текст.

[Kineshma]

А мне статья очень понравилась, спасибо автору за удобоваримое напоминание простых правил конструктивной критики, т.е. о том, как сказать о недочетах работы так, чтобы не оскорбить, не обидеть, не отбить желание работать, а, напротив, поддержать и помочь исправить недостатки.

[Mingun]

Растяжка мышц всего тела

Получите 40 онлайн-тренировок, вместо абонемента в зал. Воспользуйтесь безопасным гайдом по стретчингу в домашних условиях. Мышцы вашего тела расслабятся, уйдут зажимы, улучшится самочувствие и координация движений.

Но ведь в оригинале не предлагают «40 онлайн-тренировок»! Наоборот, предлагают «гайд» вместо зала и/или 40 тренировок из интернета, ведущих к плохому самочувствию.

[Mike-M]

Я бы еще заменил ненужный англицизм "гайд" на "руководство".

[Dmitriy_Mironiuk]

@Mike-MСпасибо, хорошее предложение. Действительно, лучше избегать англицизмы в текстах. Для рекламного спича, который я привел как пример, это не так критично, но в технической документации нужно обязательно соблюдать такое правило.

[Dmitriy_Mironiuk]

@Mingun Благодарю за внимательность и проявленный интерес. Вы абсолютно правы, фраза «получите 40 онлайн-тренировок» здесь лишняя. Но о том, что именно тренировки ведут к плохому самочувствию, автор не говорит. Наиболее правильный вариант, по-моему, вот такой:

«Воспользуйтесь безопасным руководством по стретчингу в домашних условиях вместо абонемента в зал. Мышцы вашего тела расслабятся, уйдут зажимы, улучшится самочувствие и координация движений».

Если у вас есть свои варианты, буду рад почитать.