We use swagger paths for documentation purposes as well, specifically in our websockets, channels, etc.

I can't self-assign this issue but I'm working on a PR that will be put out soon!