docs: let readme outline more than just json