bodyFormatenum
Формат содержимого тела комментария (переводного текста) следующий:
1. Структура и порядок: Сохраняй исходную структуру, порядок предложений и разбивку на абзацы точно так же, как в оригинале. Не меняй последовательность мыслей.
2. Технические детали: Не выбрасывай и не сокращай технические детали. Все термины, названия, идентификаторы, пути, форматы (например, /org/project, http:, file:) переноси без изменений.
3. Смысл: Передавай смысл максимально точно, без искажений и домыслов.
4. Имена собственные и бренды: Не переводи и не изменяй имена собственные, названия брендов, технические названия, идентификаторы, названия инструментов, функций, параметров и форматов.
5. Выделение заглавными: Если в оригинале слово выделено ЗАГЛАВНЫМИ буквами (например, UNLESS), сохраняй такое выделение и в переводе.
6. Глаголы: Описания инструментов и действий переводи глаголами в 3-м лице единственного числа настоящего времени изъявительного наклонения (например, «получает», «вызывает», «преобразует»), а не инфинитивом («получать») и не повелительным наклонением («получи»).
7. Дополнения: Существительные-дополнения ставь в винительном падеже (например, «вызывает инструмент», «преобразует ресурс»).
8. Стиль: Пиши живым, разговорным, но не панибратским тоном — как толковый разработчик коротко объясняет коллеге. Избегай канцелярита, отглагольных существительных там, где можно использовать глаголы, и активных конструкций.
9. Запрещённые обороты: Не используй:
- Длинное тире «—» (используй дефис «-» или другие знаки препинания, допустимые в оригинале);
- Кальки-обороты: «данный», «является», «представляет собой», «стоит отметить», «важно понимать», «в современном мире», «играет ключевую роль», «позволяет осуществить», «обеспечивает возможность»;
- Негативные параллелизмы: «не просто X, а Y», «не только X, но и Y»;
- Формульные выводы: «таким образом», «подводя итог»;
- Раздувание значимости и пустые усилители: «мощный инструмент», «открывает новые горизонты», «выводит на новый уровень»;
- Модальное хеджирование в каждом предложении: «может стать», «способен обеспечить», «призван решить».
10. Начало: Начинай сразу с сути, без вводных фраз и разгонов.
11. Вывод: Выводи только сам перевод, без кавычек, заголовков и пояснений.
entryIdstringобязательный
Уникальный идентификатор записи, для которой нужно получить комментарии.
environmentIdstringобязательный
Идентификатор среды в пространстве, по умолчанию он будет называться Master.
limitnumber
Максимальное количество возвращаемых комментариев (по умолчанию: 25)
skipnumber
Количество комментариев для пропуска при пагинации (по умолчанию: 0)
spaceIdstringобязательный
Идентификатор пространства Contentful. Это должен быть именно идентификатор пространства, а не его название; если он неясен, запросите его.
statusenum
Фильтровать комментарии по статусу.