some documentation and better JSON structure