Lorna Jane Mitchell

I think I understand. It's a common use case to split the OpenAPI descriptions to make easier maintanance, but as you have already discovered, not all tools support that structure....

Closing since it's unlikely that we'd implement additional options for partial splitting. My recommendation is to split the files to make them easier to work on, but if needed then...

That's pretty cool. Did you see that we also added a markdown output format to the lint command? It's in #1559 - merged but not released yet.

It's in 1.13.0 onwards, so I'll close this issue since I don't think there's anything more for us to do here (but still happy to hear feedback!)

I didn't understand your remark about why per-api definitions wouldn't work but there are a few different approaches you could try: - write a separate config file for each of...

I think present tense makes sense, so `excludePaths` in this case.

Thanks @dianacheung ! I see it and it's on my list, we will review when we can.

A new commit please

@dianacheung don't worry about the broken link, I'll take a look at that separately

Thanks @steve-nay-sage , this is good info! Like @RomanHotsiy says, keeping things identical is difficult because we're parsing it in, making a new structure, and writing it back out. We...