opendoor/pggen

add a `comment` configuration option

ethanpailes opened this issue · 0 comments

Users should be able to explicitly configure a comment to place on functions generated by custom queries. This way IDEs can explain what a query does without people even needing to pop open the toml file.

There should also be a new global config option require_query_comments = <true|false> that lets you demand that all queries come with a comment explaining what is going on with them.

For bonus points we can pull comments right out of the database for stored functions. This feature is almost never used though, so I'm not sure how important it is.