Hacker News new | ask | show | jobs
by spondyl 2843 days ago
Oh hey, I recognise your name :)

I just want to say thanks for your efforts on swagger-inline!

I was actually looking for a tool just like it earlier this year. The project I was using it with was in Python so unfortunately we couldn't justify adding a dependency on Node just for one tool.

It did inspire me to write my own similar tool from scratch, compatible with OAS 3.0. Unfortunately it's not open source just yet but I've got most of the sign off I need so hopefully I can release it into the wild sometime.

In our particular use case, we have a series of microservices that inherit from a shared codebase (controllers etc). Funnily enough, I ran into trouble trying to document controller routes bceause... there were none! They were all inherited, haha.

Anyway, I'm impressed that you're still across a number of repos! Maybe Readme is a bit smaller than I figure assumed?

1 comments

Awesome! I love the idea of keeping the docs right in the code :)

Here's the parent project: http://openap.is/

I don't write code much anymore, but when I do it tends to be non-production stuff like this. (We're a 11-person company!)