YAML is simpler for human to read/write than JSON, at least because it is less verbose. It is also richer as it let describe with comment and have multiline support.
An OpenAPI description of OpenKarotzAPI.
Description
Languages
Python
53%
Makefile
47%