keras-team/keras-autodoc

Empty lines between arguments are not rendered correctly.

gabrieldemarmiesse opened this issue · 1 comments

Overall, this is more a general issue with the https://github.com/keras-team/keras-autodoc/blob/master/keras_autodoc/docstring.py file. It's overly complicated. Some refactoring would be welcomed.

At the same time, if the code is simpler, it should be easier to fix the test currently failing:

def test_generate_docstring_with_empty_line():

Actually, it shouldn't be a behavior that we would want. It would make the docstring harder to read.