neogen icon indicating copy to clipboard operation
neogen copied to clipboard

Python: Should Raises be after Return in google style?

Open hassec opened this issue 1 year ago • 1 comments

I noticed that the generated doc always has the Raises: section before Returns:. If I understand correctly, this is due to the current template looking like:

https://github.com/danymat/neogen/blob/4b22542b96712a5a901fa909b7dc749251ae1625/lua/neogen/templates/google_docstrings.lua#L22-L26

The Google Style Guide has Raises: after Returns: in all examples.

Should we follow the pattern suggested in the style guide and move Raises: after Returns:?

hassec avatar Aug 05 '24 12:08 hassec

Seems to be the way I confirm we can change it the other way around then

danymat avatar Aug 05 '24 14:08 danymat