Համակարգչային գիտության մեջ կա միայն երկու դժվար բան՝ քեշի անվավերացում և իրերի անվանումներ: Քեշի անվավերությունը կարծես ճիշտ է, բայց իրերի անուններ տալը, իրո՞ք:

Այո, իսկապես այդպես է։ Դուք միակը չեք աշխարհում, ով դա զգում է, և նույնիսկ ավելի դժվար է, քան կարծում եք, երբ ձեր ծածկագիրը պետք է լինի ինքնուրույն փաստաթուղթ:

Ենթադրենք, ես ունեմ գործառույթ.

Լավ, x-ը հենց X ֆունկցիա է: Եթե ​​ինչ-որ մեկը պետք է կարդա այս ծածկագրերը, նա ինձ մոտ կգա 1 վրկ հետո՝ առանց փորձելու այն հասկանալու: Համակարգչային աշխարհում յուրաքանչյուր համակարգիչ կարող է դա հասկանալ, բայց իրական աշխարհում, հավանաբար, ես միակն եմ, ով հասկանում է դա:

Ահա ընթեռնելի տարբերակ.

Ծանոթ է, չէ՞: Բայց պարզվում է, որ կրտսեր ծրագրավորողների կոդերը չեն կարող լինել աղետ, ինչպես առաջին գործառույթը, բայց ինչ-որ տեղ 70%: Խնդիրն այն է, որ նրանք դա չեն գիտակցում։ Եթե ​​դուք եք նա, ով գրում է ծածկագիրը, ապա ընդհանրապես կախարդանք չկա, բայց եթե դուք եք նա, ով կարդում է կոդը, ամեն ինչ կարող է հրաշք լինել:

Մենք՝ մշակողներս, արժանի ենք ավելի լավ կոդերի՝ և՛ այն, ինչ գրում ենք, և՛ այն, ինչ կարդում ենք: Ինչպես նշեցի իմ առաջին հոդվածում՝ Կոդավորման Տաո-ում, մեր օրերում կոդավորումը մարդու և մարդու գործն է, ինչո՞ւ մենք չենք հեշտացնում մեր կյանքը: Որոշ կոդեր աշխատեցնելու և դեն նետելու փոխարեն, մենք կարող ենք մեր կոդի յուրաքանչյուր տող դարձնել բազմակի օգտագործման, արժեքավոր և ընթեռնելի մեր հաջորդ սերնդի համար, այնպես որ ձեր միտքը դրեք դրա վրա:

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

Կան մի շարք բաներ, և դժվար է բացատրել կոդերը: Բայց մենք կարող ենք օգնել ընթերցողին մի փոքր ջանք գործադրելով հասկանալու միտքը՝ մեր հիմնական գործառույթն ավելի ինքնավաստագրելով:

Ի դեպ, դա միայն ֆունկցիոնալ ծրագրավորման համար չէ: OOP-ում կամ ծրագրավորման այլ պարադիգմներում նույնպես անհրաժեշտ է ինքնուրույն փաստաթղթավորում:

Եվս մեկ բան, երբևէ նկատե՞լ եք, որ այն, ինչ մենք անում ենք ամեն օր, կոդ գրելն է, որպեսզի կարողանանք ձեզ գրող անվանել: Եթե ​​բիզնեսը թեմա է, և մենք ցանկանում ենք այն փոխանցել մարդկանց, մյուս ծրագրավորողներին, մենք պետք է լինենք հեքիաթասաց՝ նա, ով պատմություններ է պատմում: Նայեք շրջանակներին կամ գրադարաններին, նրանք ամեն կերպ փորձում են մեզ իմաստալից անուններ կամ օրինաչափություններ տրամադրել, օրինակ՝ it('should ...') կամ isEqual(): Օգտվեք դրանից, մենք բացարձակապես կարող ենք արվեստագետներ լինել ծրագրավորման աշխարհում:

Ուրախ կոդավորում, շնորհակալություն: :)

Հեղինակ՝ Դեյվիդ Հեյզլենդ @ Lecle VietNam Blog