Query on SoftUpdateDocument API

Hello, Lucene community!

I am reaching out to you to seek help with one of the updated APIs.

I have a use case where I need to update the Lucene document's docValue
fields in place, i.e., without creating a new document with every update. I
believe softUpdateDocument should help me achieve this, but I'm a bit
confused about the documentation,

These are the questions I have:

1. Does the softUpdateDocument API create a new document with every new
update? If so, how is it different from the updateDocument API? Is this the
correct API for my use case, where I don't have to increase the segment
size because of a huge influx of docValue updates?

2. The softUpdateDocument takes two arguments: a Document and varargs of
type Field. If my Document consists of different types of fields (string,
docValues, text), should I send in the same document with all the fields or
create a new document with only the supporting docValue fields?

I hope to hear from you soon.

Thank you so much!

-Abhishek