docs: improving json generation