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

Front

Պարզություն և ընթեռնելիություն

Back

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

Front

Հասկանալի անուններ

Back

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

Front

Մեկ ֆունկցիա = մեկ առաջադրանք

Back

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

Front

Ձևավորում

Back

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

Front

Մեկնաբանություններ

Back

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