We no longer use JSON schema define our API, and it is stale. After talking with the DCOS-UI team, they revealed that they no longer have not used the JSON schema for a long time. It is tedious an a source of error-prone to have to maintain both. It doesn't seem worth it (or, potentially, completely possible) to automatically convert our RAML to JSON schema.
We also, currently, expose the JSON schema via an API endpoint (/v2/schema, see SchemaResource.scala). This means that some clients out there could still be depending on it.
We will follow our deprecation policy for removing endpoints. In a future 1.x.0 release, we will disable the endpoint by default, enabling it with a feature flag. Then, in a subsequent major 1.x.0 release, we will remove it all all supporting code altogether.
As a user
In order to help me be aware that I am using deprecated endpoints,
I want it to be obvious that I am querying a deprecated interface
In order to prevent a jarring and frustrating rollback (or an extremely rushed change to some tool),
I want to be able to optionally continue to use this deprecated a short while longer without having to roll back Marathon