Стилистические вопросы в новом переводе

[gaearon]

Привет.

Перед тем как мержить первые страницы, давайте в этом треде поговорим про общую стилистику. Чтобы было одинаково между страницами. Несколько вопросов, которые сразу приходят на ум:

• Мы много используем “you” в новой доке. В переводе это будет «ты» или «вы»? Например, Your First Component.
• Названия многих страниц используют герундий (“Passing Props to a Component”). Это что — «Передача пропсов», «Передаем пропсы», что-то еще?

Если есть какие-то похожие моменты, давайте их тут поднимем тоже.

[EngiN33R]

Моё мнение по двум вопросам в начале треда:

• Считаю, что когда без обращения к читателю не обойтись, "вы" с маленькой буквы - самый оптимальный вариант, чтобы поддержать баланс фамильярности и официальности, к которому призывает стилистический гайд
• С пунктом про герундий сложнее, но я голосую за формы "мы", т.е. "Передаём" - так больше ощущается, что мы устанавливаем с читателем контакт, и меньше ощущается канцелярит, которого в техдоках и так всегда хватает

[dmaykov]

По поводу пропсов, я думаю можно добавить слово "данные" или "значения", например "Передавать данные через пропсы" или "Передавать значение через пропс"

[gaearon]

У меня больше вопрос именно про герундий. У нас очень много таких страниц с -ing:

• Describing the UI
• Importing and Exporting Components
• Writing Markup with JSX
• Passing Props to a Component
• Keeping Components Pure
• Extracting State Logic into a Reducer

и так далее. Идея в том, что каждая страница описывает какой-то один skill или workflow. Так что хотелось бы, чтобы в переводе тоже какая-то общая схема была для этих названий.

[Hellnar]

1. Не думаю, что обращение на "ты" допустимо в документации. Обращение на "вы" вряд ли кого-то заденет. А на "ты" - может. Поэтому здесь я бы сохранял обращение на "вы".

2. По поводу герундия, в тайтлах я бы использовал "Передача пропсов", как обозначение категории, а не действия.
   Если герундий встречается в инструкции, тогда можно "Передаем пропсы", как обозначение действия.

[gaearon]

Какие сейчас самые передовые технические ресурсы на русском? Я давно не смотрел ничего.

[Hellnar]

• Можно посмотреть на Git Book на русском языке. В книге используется "Установка Git", не "Устанавливаем Git" и т.д.
• MDN. "Установка базового программного обеспечения", а не "Устанавливаем базовое программное обеспечение"
• Node.js - "Докеризация веб-приложения Node.js", а не "Докеризируем веб-приложения Node.js"

[gaearon]

Хорошо. Тогда вроде бы есть консенсус:

• Обращаемся на «вы»
• Переводим герундий как существительное в заголовках, а прямо в тексте зависит от ситуации

[gaearon]

Если есть еще стилистические вопросы, которые стоит обсудить, кидайте сюда тоже )

[gcor]

Начал соседнее ишью про перевод слов state и node #849 )

[Hellnar]

Похожая ситуация со словами, как в #849

• Valid: я использовал в переводе "валидный", поскольку слово уже вошло в обиход. Но возможно есть смысл использовать "корректный", "правильный" или какой-то другой вариант.
• Merge, Pull request: я в переводе также перевел их (по аналогии с русской версией от Git "слияние", "запрос на слияние"). Но хотелось бы понимать, будет ли такой вариант правильным или лучше использовать "мердж" и "пул реквест".

[rainyEra]

В старой доке мне не нравилось то, что очень сильно сохранялась стилистика оригинального языка. Т.е прямо чувствуется, когда ты читаешь, что как-то не по-русски звучит. Например, "Условный рендеринг" как-то не звучит по-русски. Когда мы читаем, то первая ассоциация к этому слову — условно(не существуя на самом деле), поэтому в самой доке я перевёл так:

Вашим компонентам нужно часто отображать различные вещи в зависимости от различных условий. В React вы можете рендерить JSX в зависимости от его условий

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

[gaearon]

Да, я думаю в целом мы все за то, чтобы язык читался естественно, но не всегда очевидно, как этого достичь ) К примеру, как перевести Conditional Rendering (название страницы)?

[rainyEra]

Да, я думаю в целом мы все за то, чтобы язык читался естественно, но не всегда очевидно, как этого достичь ) К примеру, как перевести Conditional Rendering (название страницы)?

Да, полностью с Вами согласен. Условный рендеринг можно оставить, а в самой доке переводя как-бы пояснять это слово. Я там прикрепил пример "в зависимости от его условий" — звучит гораздо живее, чем каждый раз повторять одно и то же слово. Как-бы чтобы и слишком по-русски не звучало и слишком по-английски.

[boldurean]

Есть некоторые вещи которые надо перевести глобально и замерджить их до перевода страниц.
Например, карточки, табы, хлебные крошки (DeepDive - Глубокое погружение, Note - Примечание и т.д)

Сейчас перевожу you may not need an effect, могу попутно перевести вышеперечисленное.