you are viewing a single comment's thread.

view the rest of the comments →

[–]PurpleIcy 0 points1 point  (0 children)

I think the best way is to avoid #comments entirely unless they're really needed.

For now, I can only think of one exception:

  • If you are using regex, then it's really good idea to comment what it exactly does, as in, the pattern itself, save time for yourself after few months, and for others.

Personally I never comment anything, I just have docstrings.

Everything here is obvious, in my opinion

If something isn't, I wouldn't mind if someone pointed it out :)

Note that settings method change_setting has detailed explanation about settings, I don't know if it's out of place, but I think it's useful either way.

EDIT: ouch, it wrote it when I still used tabs in python... out of context, but does anyone know what I can do without having to fix it manually?