notes make swagger json from yaml http://stackoverflow.com/a/34776563/1091766 editing specs / and has linter http://editor.swagger.io/#/