GSoD 2020 - OpenMRS REST API Documentation

I was working on the draft of Encounter section in rest documentation, and I was going through this thread here, and I saw the example in which we pass visit information for creating a encounter, what would be preferred way of creating a new encounter by passing a visit object or just a UUID of the ongoing visit of which this encounter is a part of, are there any specific use cases where passing in a visit object would be preferred?

cc @ayesh @gcliff.