widdershins
widdershins copied to clipboard
Allow to pass an array instead of single apiObj for microservices
Instead of passing an apiObj, we could pass an array of apiObj to convert into a markdown with nested fields (h1, h2, h3) for microservices
Although this is a good idea, and we can consider it further, in the Unix spirit of "doing one thing and doing it well", have you looked at https://github.com/Typeform/openapi-micro-merge ? It might suit your needs as a pre-processing step before calling widdershins?
Also some more work is necessary to get more / variable levels of header support in the TOC.
Thanks for pointing out to openapi-micro-merge.
Unfortunately it does not suits my needs as it merge all swagger files into one file - resulting in duplicate entries.
Tweaking around widdershins would work. I think manually generating the header and only the markdown for each of the swagger files would be fine.
If openapi-micro-merge
creates duplicate entries, it might be worth raising an issue there?
It won't be trivial to adapt Widdershins to output multiple definitions with all the h1
s, h2
s etc shifted down by one level (if that's what you want), though I will bear it in mind for the upcoming rewrite of the OpenAPI templates.
Is this any better for your use-case with Widdershins v3.0.x?
I am not sure. How 3.0.x improve my use case ? Can you provide a quick example ?
It should be easier to amend the stock templates to increase the heading levels by one in v3.0.x and combine using a version of your script. Other than that, there is no additional support yet.
A note that @shreyas-agnihotri had the same issue/request. Mentioned https://github.com/maxdome/swagger-combine, though https://github.com/Typeform/openapi-micro-merge also worth looking at. Both OpenAPI 2.0 only as far as I can see.