update docs
generate valid json spec