Making better bundle available to the OAS community

[philsturgeon]

Summary

There are infinite issues on countless packages asking for this new and improved bundling, on our repos (which is why we did it) and various APIDevTools repos.

• Bundle behavior feels illogical APIDevTools/swagger-parser#127
• Bundle: option to keep all refs but turn them into internal refs APIDevTools/swagger-cli#29
• I'll add a bunch more shortly, im still on holiday 😇

Can we either, document our fork so people know how the new bundling logic works, or merge our changes back into the upstream so everyone has access to it without needing to switch to our fork?

Tasks

• Document optimized bundling
• and/or
• Merge this functionality upstream to APIDevTools/json-schema-ref-parser so we dont need to maintain this fork

Additional context

It would make a lot of people out there very happy to know we're helping.

[marcelstoer]

Can we either, document our fork so people know how the new bundling logic works [...]

Nit pick: for me this is not "either"; documentation would be helpful with or w/o merging the changes upstream 😉

I am reluctant to attempt to switch to your fork because the tests appear to have been broken since Mar 19, 2021 and no one bothered fix that 🙍‍♂️

[philsturgeon]

Unnecessary nit pick. If merging changes back upstream they'd be documented there. Otherwise it would be documented here. Come on. If you're about to start a sentence with "nit pick" probably just delete that sentence.

@mnaumanali94 can you get this on somebodies radar as I don't work here anymore? :D