doc update and cleanup
json example