Generate a better API file name when saving as JSON/YAML

[EricWittmann]

From @mmajerni : "Regarding Saving as JSON/YAML, it will be great to have an opportunity to change an API file name. Now, all saved API's have name openapi-spec.json/yaml. "

I think the best option is to generate a filename from the API title. Another option is to prompt the user for a filename.

@chirino do you have an opinion on this?

[chirino]

I don’t think it’s a bad idea, but I also don’t think it should be high on the priority list.

[EricWittmann]

@chirino Fair enough - do you have a preference between the two approaches?

1. Prompt for filename
2. Use the API title as the filename (sanitized)

[chirino]

Don’t really have a preference.

[EricWittmann]

3. RANDOM NAME!

[amysueg]

I think using the API title (sanitized) as the default filename makes the most sense here @EricWittmann @chirino

[chirino]

Keep in mind that we name the document open-api.json in all the camel projects by convention. Keeping to the existing default makes it easier to work with camel projects.

[schelv]

openapi.yaml or openapi.json are the names recommended in the specification