Going through my code with pylint, I found that there is no way to filter 
by the type of missing docstring. I.e. missing-docstring catches functions, 
classes, methods, and modules. As a result, it gives a warning on for every 
default Django file. Accordingly, I would like to suggest that the current 
automatically generated comments of "Create your __ here" that are 
generated for each file created by manage.py startapp be replaced with 
docstrings that follow the PEP 257 convention. The second line of the 
specification: All modules should normally have docstrings, and all 
functions and classes exported by a module should also have docstrings.



You received this message because you are subscribed to the Google Groups 
"Django developers  (Contributions to Django itself)" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to django-developers+unsubscr...@googlegroups.com.
To post to this group, send email to django-developers@googlegroups.com.
Visit this group at https://groups.google.com/group/django-developers.
To view this discussion on the web visit 
For more options, visit https://groups.google.com/d/optout.

Reply via email to