Gunakan Nama Identifier yang Deskriptif

Program berikut menggunakan penamaan identifier yang buruk:

def find(p):
    res = []
    for e in p.els:
        if e.n == "img":
            res.append(e)
    return res

Bisakah kamu memahami apa yang dilakukannya? Kemungkinan besar tidak.

Solusi

Gunakan nama yang lebih deskriptif:

def get_image_elements(html_page):
    elements = []
    for element in html_page.elements:
        if element.name == "img":
            elements.append(element)
    return elements

Sekarang kita dapat dengan mudah mengetahui bahwa fungsi di atas akan mencari semua elemen image di dalam sebuah halaman HTML.

Kesimpulan

Kebiasaan menggunakan nama yang bagus akan membuat program kita dapat dengan lebih mudah dipahami.