Skip to content

Specifications, standards, guides and conventions related to Python

Notifications You must be signed in to change notification settings

zensoftio/python-stack-spec

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 

Repository files navigation

Before writing any Python code

Python Style Guides

PEP 8 -- Style Guide for Python Code PEP 3000 -- Python 3000

Naming

There is a good article on how to name variable names. Good variable names

Documentation

Write documentation only if you think other developers may have problems with understanding functions, methods, classes, modules or packages.

Do not describe obvious things in documentation like:

#BAD! never do it!

def add(x, y):
    """Returns sum of x and y"""
    return x + y

Docstring style - Google Style Python Docstrings

Commit checklist

About

Specifications, standards, guides and conventions related to Python

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published