{"meta":{"title":"Написание содержимого для перевода","intro":"Наша документация переведена на несколько языков. Как мы подходим к написанию документации по английскому языку, значительно улучшили качество этих переводов.","product":"Участие в документации GitHub","breadcrumbs":[{"href":"/ru/contributing","title":"Участие в документации GitHub"},{"href":"/ru/contributing/writing-for-github-docs","title":"Написание для GitHub Docs"},{"href":"/ru/contributing/writing-for-github-docs/writing-content-to-be-translated","title":"Запись содержимого для перевода"}],"documentType":"article"},"body":"# Написание содержимого для перевода\n\nНаша документация переведена на несколько языков. Как мы подходим к написанию документации по английскому языку, значительно улучшили качество этих переводов.\n\n## О написании содержимого, понятного для перевода\n\nИспользуйте следующие рекомендации, чтобы убедиться, что создаваемое содержимое можно успешно преобразовать. Дополнительные сведения см [. в руководстве по](/ru/contributing/style-guide-and-content-model/style-guide) стилю.\n\n* Используйте примеры, которые являются универсальными и могут быть понятны большинству людей.\n* Избегайте примеров, которые являются спорными или культурно характерными для группы.\n* Запись в активном голосе.\n* Написание простых, коротких и простых предложений.\n* Избегайте использования слишком много существительных, которые могут сделать текст неясным.\n* Избегайте использования сленга и шутки.\n* Избегайте отрицательных предложений.\n* Используйте стандартные акронимы в отрасли, когда это возможно, и объясните пользовательские акронимы.\n* Используйте показательное настроение.\n* Исключите избыточные и слововые выражения.\n* Избегайте чрезмерного использования модификаторов с накоплением (строки существительных). Переводчик может неправильно понять, какое существительное является измененным.\n* Избегайте невидимых плюралистов, в которых не ясно, если первое существительное должно быть единственной или множественной.\n* Избегайте инициализации.\n* Избегайте использования неоднозначных модальных вспомогательных команд.\n* Избегайте слов, характерных для пола.\n* Избегайте предпозиционных фраз.\n* Избегайте расплывчатых существительных и существительных (расплывчатый предмет предложения).\n* Сохраняйте встроенные ссылки к минимуму. Если они необходимы, предусловите их фразой, например \"Дополнительные сведения, см. в разделе \"Название ссылки\". Кроме того, добавьте соответствующие ссылки в раздел \"Дополнительное чтение\" в конце раздела.\n\n## Примеры\n\nВ этом разделе приведены примеры того, как следовать нашим рекомендациям по написанию документации по переводу.\n\n### Избегайте сведений о конкретной стране\n\nНапример, избегайте 800 чисел и адресов в конкретной стране. При необходимости укажите, к каким странам применяется информация.\n\n### Избегайте чрезмерного использования модификаторов с накоплением (строки существительных)\n\nМножество модификаторов с накоплением может привести к неправильным переводам, так как это не легко определить, что изменяет. Например, используйте параметр \"Параметры источника по умолчанию для общедоступный репозиторий\" вместо \"общедоступный репозиторий параметров источника по умолчанию\".\n\n### Избегайте невидимых плюралистов\n\nНапример, при использовании термина \"извлечение файлов\" неясно, извлекают ли вы один файл или все файлы. Укажите больше контекста для устранения неоднозначности. В приведенном примере можно использовать \"извлечение всех файлов\" или \"извлечение файла source.md\".\n\n### Избегайте инициализации\n\nНапример, вместо того, чтобы \"прийти к выводу\", используйте \"заключение\".\n\n### Избегайте использования неоднозначных модальных вспомогательных команд.\n\nИзбегайте использования таких слов, как \"может\" и \"может\". Будьте более ясны, чтобы избежать неоднозначности.\n\n### Избегайте предпозиционных фраз\n\nВместо написания \"после многократной попытки\" или \"в соответствии с журналом репозитория\", напишите больше напрямую. Например, \"после попытки три раза\".\n\n### Избегайте расплывчатых существительных и существительных\n\nРасплывчатые существительные и существительные могут сделать его неясным, кто или что вы ссылаетесь, особенно когда это содержимое должно быть переведено. Например, \"Обслуживающие и участники имеют доступ к файлам и комментариям. В запросе на вытягивание они вносят изменения в него\". В этом предложении не ясно, вносятся ли изменения в файл или комментарии. Если существительное, как представляется, ссылается на несколько ацедентов, либо переформулирует предложение, чтобы сделать протекedent ясным или заменить его существительным, чтобы устранить неоднозначность.\n\n### Сохраняйте встроенные ссылки к минимуму.\n\nГде это возможно, четко введите ссылки после нашего руководства по стилю. Например, вместо следующего предложения:\n\n```markdown\nRead [more about OAuth2.](/apps/building-integrations/setting-up-and-registering-oauth-apps/) Note that OAuth2 tokens can be [acquired programmatically](/rest/reference/oauth-authorizations/#create-a-new-authorization), for applications that are not websites.\n```\n\nВместо этого можно использовать следующее:\n\n```markdown\nOAuth2 tokens can be acquired programmatically for applications that are not websites. For more information, see [AUTOTITLE](apps/building-integrations/setting-up-and-registering-oauth-apps/) and [Create a new authorization](/rest/reference/oauth-authorizations/#create-a-new-authorization).\n```"}