Как находить и объяснять жаргон для своей аудитории.
Термин может быть уместен для экспертов и непонятен новичкам. Сначала определите аудиторию, затем объясняйте незнакомые термины при первом подходящем употреблении.
Адаптируйте процесс под свою задачу.
Оцените вероятные знания читателя и отметьте термины, мешающие пониманию. Сохраняйте необходимую точную терминологию, добавляя простое объяснение при первом подходящем употреблении, а не заменяя все термины.
- Что вы предоставляете
- Специализированный текст и профиль читателя.
- Что вы получите
- Отмеченный необъяснённый жаргон с определениями.
Посмотрите входные данные и результат.
Иллюстративные входные и выходные данные · учебный пример, а не реальный запуск WebAct
Полей ввода: Пример
Explain to a new customer: Configure the webhook and inspect the payload.
Готовый пример
Set up the webhook, an automatic message sent between services, then check the payload: the data included in that message.
Добавьте эти данные в промпт и скопируйте его в WebAct, чтобы попробовать задачу. Ваш результат может отличаться от примера.
Решения и устранение проблем.
Нужно ли убирать специальные термины из документации для экспертов?
Нет. Объясняйте только то, что нужно целевому читателю. Устоявшиеся термины могут сделать экспертную документацию короче и точнее.
Что делать, если простая замена неточна?
Сохраните исходный термин и добавьте краткое определение или пример. Привычный, но неточный синоним может запутать ещё сильнее.
Попробуйте на собственном источнике.
Замените пример своим материалом в промпте. Сохраните нужные требования и скопируйте задачу в WebAct.
Настроить и скопировать задачу ↑