fix(field): say a title is rich text limited to one heading

[angeloashmore]

Resolves: #275

Description

Before this PR, prismic field add text --help did not say that Prismic models a title as rich text limited to one heading. The convention appeared only in the EXAMPLES section of prismic field add rich-text --help, which a reader reaches only if they already suspect rich text.

For example, someone who needs a title runs prismic field add text title and never learns otherwise.

After this PR, the text help states the convention and gives the command for a title. The text row in prismic field add --help carries the same pointer.

No command behavior changes. This is help text only.

Checklist

• If my changes require tests, I added them.
• If my changes affect backward compatibility, it has been discussed.
• If my changes require an update to the CONTRIBUTING.md guide, I updated it.

Preview

prismic field add text --help:

Add a text field to a slice or custom type.

A text field holds a short plain string with no formatting.

For a title or a heading, rich text limited to a single heading block
is usually a better fit:

  prismic field add rich-text title --to-type blog_post --allow heading1 --single

How to QA ¹

$ node --run build
$ IS_SANDBOX=1 EVAL_TRIALS=10 PRISMIC_ALLOW_EVALS=true node --run evals -- \
    evals/design-sensible-models.eval.ts \
    -t "models a title as single-heading rich text"

🤖 Generated with Claude Code

https://claude.ai/code/session_01YRv7FgAiL76NgBHywdGKPC

Footnotes

1. Please use these labels when submitting a review:
   ❓ #ask: Ask a question.
   💡 #idea: Suggest an idea.
   ⚠️ #issue: Strongly suggest a change.
   🎉 #nice: Share a compliment. ↩