kbendick edited a comment on pull request #4004:
URL: https://github.com/apache/iceberg/pull/4004#issuecomment-1025060021


   > Great, looks more consistent
   
   It also parses better in various CLI tools outside of editor.swagger.io!
   
   As a follow up, I intend to add some documentation about using some of these 
tools, and ideally a Github Action to validate the specification file once a 
good CLI tool is determined. Everything I've found so far is installed via 
`npm` or  `pip` and I haven't been able to determine if there's consensus 
around the best tool (or even top 3 best CLI tools). I'm not one to dive right 
in on bringing in an `npm` based dependency without some research.
   
   It's presently valid per `editor.swagger.io` - which is a paid / enterprise 
tool (with a free tier) which focuses in this space (open api docs). So I'm 
continuing to use editor.swagger.io as the canonical validation tool, but 
fixing things that could be made better for parsing in other tools.
   
   So this is a step in that direction, as well as looking more consistent. 🙂 


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]



---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to