Andrew,

Versioning is something that would be very important for us if/when the API does eventually fully replace the SDK. We have a few critical processes that work with versioned documents to enable versioning, set/check version comments, update versions, and delete versions.

The most important thing for us would be the ability to group a set of changes within a single version. As an example, if we use standard workflow activities to update pages, metadata, etc. on a versioned document, it creates multiple new versions because of the separate activities.

Instead, we typically use SDK code because then we can apply multiple changes at once before saving so we only get one new version with all the changes together, and I think it would be incredibly important to also be able to do this with the API.