Naming, ฟังก์ชันที่ดี & Docstring

# ❌ ต้องเดาว่าอะไรคืออะไร
d = 86400
for x in lst:
    if x[2] > 18:
        r.append(x)

# ✅ อ่านแล้วเข้าใจทันที
SECONDS_PER_DAY = 86400
for user in users:
    if user["age"] > ADULT_AGE:
        adults.append(user)

# ❌ ฟังก์ชันเดียวทำหลายเรื่อง
def process(users):
    for u in users:
        if "@" in u["email"]:        # validate
            u["email"] = u["email"].lower()   # normalize
            send_email(u["email"])    # ส่งเมล

# ✅ แตกเป็นฟังก์ชันที่ทำอย่างเดียว ชื่อบอกหน้าที่
def is_valid_email(email):
    return "@" in email

def normalize_email(email):
    return email.lower()

def notify_users(users):
    for u in users:
        if is_valid_email(u["email"]):
            send_email(normalize_email(u["email"]))

def calculate_discount(price, percent):
    """คำนวณราคาหลังหักส่วนลด

    Args:
        price: ราคาเต็ม (บาท)
        percent: เปอร์เซ็นต์ส่วนลด (0-100)
    Returns:
        ราคาหลังหักส่วนลด
    """
    return price * (1 - percent / 100)

help(calculate_discount)   # แสดง docstring