I think most people consider it a big advantage to have the docs next to the function, since they change together. I agree the phoenix_swagger DSL feels a bit “intrusive,” I prefer to use module attributes and build the open_api JSON from those.
I built docout to make it easier to use custom notation to convert function docs into documentation files (like an open_api.json) during the compilation phase.
