add docs for the new json format Upstream-commit: 0e2b0f284c1acfbb152ccca77417b4e132a4355b Component: engine