Ինչ է, ձեր կարծիքով, որ նշանակում է որակյալ կոդ գրել?

Աստվածային, ընթերցելի, պահպանելի, փորձարկելի, անվտանգ, արդյունավետություն, համապատասխանություն ստանդարտներին և նախագծի պահանջներին: Կոդը պետք է հեշտ լինի հասկանալ մյուս ծրագրավորողների կողմից և ապագայում փոփոխություններ կատարելու համար:

Որակյալ կոդի հիմնական կողմերը՝

• Անգլերեն: Օգտագործել իմաստալից անուններ փոփոխականների, ֆունկցիաների և դասերի համար: Ճիշտ ձևաչափում և ներսում:
• Պահպանելիություն: Մոդուլային, թույլ կապակցված բաղադրիչներ: Մինիմալ կրկնություն կոդի (DRY - Don't Repeat Yourself):
• Փորձարկելիություն: Կոդը հեշտ է ավտոմատ և ձեռքով փորձարկել: Միավորային և ինտեգրացիոն փորձարկումներ:
• Անվտանգություն: Պաշտպանել թերությունների դեմ (XSS, SQL Injection և այլն): Վերահսկել մուտքային տվյալները:
• Արդյունավետություն: Էֆեկտիվ օգտագործել ռեսուրսները (հիշողություն, պրոցեսոր): Թողնել "կեղտոտ" հատվածներ:
• Ստանդարտների համապատասխանություն: Հետևել ընդունված կոդավորման ստանդարտներին թիմում կամ արդյունաբերությունում:
• Փաստաթղթավորում: Կոմպլեքս կոդի մեկնաբանություններ, API փաստաթղթավորում (եթե կիրառելի է):

Օրինակ՝ մաքուր և ընթերցելի կոդ:

# Հատկության հաշվարկի ֆունկցիա
def calculate_rectangle_area(width, height):
    # Ստուգել, որ մուտքային տվյալները դրական են
    if width <= 0 or height <= 0:
        raise ValueError("Լայնությունը և բարձրությունը պետք է լինեն դրական թվեր")
    return width * height

# Օգտագործում ֆունկցիայի
rectangle_width = 10
rectangle_height = 5
area = calculate_rectangle_area(rectangle_width, rectangle_height)
print(f"Հատկության մակերեսը՝ {area}")

Մակերես՝ ոչ մաքուր կոդ:

def calc_area(w, h): # Կարճ և անորոշ անուններ
    if w <= 0 or h <= 0: # Տիպի ստուգում չկա
        raise ValueError("Input must be positive") # Անտեղեկացնող սխալի հաղորդագրություն
    return w*h

Երկու օրինակների տարբերությունը ցույց է տալիս, որ ինչպես է անվանումը, ընթերցելիությունը և սխալների կառավարումը կարևոր է կոդի որակի համար։