Re: [pylons-discuss] generating docs for views

2021-03-12 Thread 'Jonathan Vanasco' via pylons-discuss
Yes, it is much closer to your pyramid_openapi3 demos. I'm not sure that project is a good candidate for my requirements or bandwidth, but I will dig into it - thanks! On Friday, March 12, 2021 at 4:52:45 PM UTC-5 Steve Piercy wrote: > My first thought was to use docstrings and Sphinx, but

Re: [pylons-discuss] generating docs for views

2021-03-12 Thread Steve Piercy
My first thought was to use docstrings and Sphinx, but I don't think that's what you want. It sounds like you want to document an API, something like pyramid_openapi3. https://github.com/Pylons/pyramid_openapi3/ RealWorld.io app API Demo (it might take a while to start up the app, as it is

[pylons-discuss] generating docs for views

2021-03-12 Thread 'Jonathan Vanasco' via pylons-discuss
I had a small Pyramid project which has grown into a much larger one. Many Views service multiple Routes (multiple calls to `@view_config()`), typically offering a default HTML version on a "bare" url, and a JSON version with a ".json" suffix to the url. Documenting these routes has become