ՁԳ Ինչպես գրել «մաքուր կոդ»

Կոդը պետք է հասկանալի լինի նույնիսկ նրանց համար, ովքեր ներգրավված չեն եղել դրա ստեղծման գործընթացում:

Կոդ գրելիս փոփոխականներին և ֆունկցիաներին պետք է տալ իմաստալից անուններ: Ցանկացած այլ անձ, կարդալով փոփոխականի անունը, պետք է հասկանա, թե ինչու է այն այդպես անվանվել։

Գործնականում յուրաքանչյուր ֆունկցիա պետք է կատարի միայն մեկ առաջադրանք: Հակառակ դեպքում նրանց համար ոչ միայն դժվար կլինի անուն ընտրելը, այլև շատ ավելի դժվար կլինի հասկանալ դրանց գործառույթը։

Ընթեռնելիությունը բարելավելու համար ծրագրի կոդում խորհուրդ է տրվում օգտագործել բացատներ և ձևաչափեր, որոնք ընդունված են այն լեզվով, որով գրում եք կոդը: Տարբեր փակագծերը և դատարկ տողերը կարող են բարելավել կոդի կառուցվածքը: Դրանց միջոցով կոդը դառնում է ավելի պարզ և հեշտ ընթերցվող։

Նույնիսկ ամենապարզ կոդի դեպքում հնարավոր է, որ դժվար լինի հասկանալ դրա բուն էությունը առանց մեկնաբանության։ Մեկնաբանությունները չպետք է լինեն շատ և ծավալուն։