Has anyone had any luck at doing any of this over REST? I'm interested in exposing space documents in a 3rd party application and integrating events from 3rd party applications into the activity stream.

1. I think you're right about rating, that may be in the Legacy REST services. However, we usually recommend using Like instead of rating, since that's a more common social affirmation pattern. The individual content type services have the like method on them.

Is there any preview documentation of changes in the core API v3. There's other functionality only in the legacy Apis that I'd like to see added. What the best mechanism to get our requirements across?

The v3 REST APIs on the current cloud release of Jive 6 are available at Jive Core REST API on our documentation website. This is about a month behind where current development is at the moment -- a lot more work in the content area has been going on recently. In addition, we're starting some work tasks to vastly improve the quantity and quality of API documentation, plus building out the JavaScript API equivalents to these REST APIs for use in Jive Apps.

If you have particular requirements you want to get on the table, a discussion here would be a good place to start that.

It would be nice to see the git repository fleshed out with PetClinic-like examples created (and maintained) with documentation to describe what the examples are and to what features they pertain. It would be nice to see one sample 3rd party integration with full CRUD capabilities (not simply read).

I'd like to see more thorough, hand written documentation embedded in the generated API docs. It would also be nice to have @since notation and summaries of the changes from one API release to the next, so that I don't have to page back and forth comparing them. Subsequent API versions should be a superset of the entire previous API with exception for functionality that has been previously deprecated and dropped.