#19907: Add additional style guidance for docstrings --------------------------------------+------------------------------------ Reporter: tga | Owner: nobody Type: Cleanup/optimization | Status: new Component: Documentation | Version: master Severity: Normal | Resolution: Keywords: comments | Triage Stage: Accepted Has patch: 0 | Needs documentation: 0 Needs tests: 0 | Patch needs improvement: 0 Easy pickings: 0 | UI/UX: 0 --------------------------------------+------------------------------------
Comment (by timo): I am in favor of continuing to use the current ad-hoc style. I find the other styles very verbose and distracting. Hopefully most code is simple enough that it doesn't need verbose docstrings. -- Ticket URL: <https://code.djangoproject.com/ticket/19907#comment:4> Django <https://code.djangoproject.com/> The Web framework for perfectionists with deadlines. -- You received this message because you are subscribed to the Google Groups "Django updates" group. To unsubscribe from this group and stop receiving emails from it, send an email to django-updates+unsubscr...@googlegroups.com. To post to this group, send email to django-updates@googlegroups.com. To view this discussion on the web visit https://groups.google.com/d/msgid/django-updates/061.1e70214c5042899995dcf104313099fd%40djangoproject.com. For more options, visit https://groups.google.com/d/optout.