Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

I do not program that much in python, but I believe the general accepted wisdom in dynamic languages was explicit name and load of documentations (as comments and docstrings).




Absolutely the general accepted wisdom in line with best practices - that are often ignored

> explicit name and load of documentations (as comments and docstrings).

Which can be out of date are often missing. Might as well use type-hints that can be statically checked.


If the name of a function and its docstring is out of date, then what you have is a bad culture for coding. It’s up there with god classes in OOP.



Consider applying for YC's Winter 2026 batch! Applications are open till Nov 10

Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: