documented some json structures (proposal)