We're working on it; meetings just started two weeks ago on our new documentation efforts: https://make.wordpress.org/core/2015/09/07/wp-rest-api-v2-docs/ https

We're working on it; meetings just started two weeks ago on our new documentation efforts: https://make.wordpress.org/core/2015/09/07/wp-rest-api-v2-docs/ https://make.wordpress.org/core/2015/09/07/wp-rest-api-v2-do... We've been short on time in the past, which is why our docs aren't up to scratch. Fingers crossed we'll get that sorted very soon!