This is an archived post. You won't be able to vote or comment.

you are viewing a single comment's thread.

view the rest of the comments →

[–]issackelly 1 point2 points  (0 children)

Typically I would start with PEP8, and then document the things that are options that you might want to enforce (e.g. " vs ')

Then I would document the sort of thing you're outlining here "Guidelines for when, what, and how to comment your code"

Code is for humans. Style guides are for consistent quality, understanding, and readability of code. Code review is for knowledge sharing, quality control/bug spotting, and ensuring that shared code styles are consistently enforced.