turpinājums: no PHP funkciju komentāri

[codez]

Un kādā valodā ir programmēšanas valoda?

Programmēšanas valoda pati ir valoda, viņai nav jābūt nekādā valodā. Tas ir tāpat kā prasīt - kādā valodā ir latviešu valoda?

[Grey_Wolf]

manuprāt kodu jāraksta angliski jo :

normāli uzrakstītu klasi var izmantot citur - neatkarīgi no klienta tautības

komentārus, ja vien nav specefiskas prasības un tas nav starptautisks, jāraksta SEV ērtākā veidā ...

 

komentārus iztulkot ir sīkums, pretstatā klases manīgo pārakstīšnai

[codez]

Atbilde: programmēšanas valodas PHP ( arī C, Python, izRuby, u.c. ) vārdiskais pieraksts ir apakškopa no angļu valodas. Q.E.D.

Bet programmējot mēs šos vārdus nekādi neizmantojam valodas kontekstā - mēs nekonstruējam teikumus angļu valodā, tie ir tikai nosaukumi, kurus mēs izmantojam, bet konstrukcijas veidojam attiecīgi PHP, js, u.c. valodās.

Bet rakstot komentārus, mēs konstruējam teikumus attiecīgajā valodā (angļu, latviešu), komentāra mērķis ir cilvēkam saprotamā valodā aprakstīt to, ko, kā un kāpēc dara tālāk uzrakstītais kods.

[codez]

Koda elementus (mainīgos, funkcijas, klases) saukt angliski vajag tāpēc, ka citi koda elementi jau ir angliski un tur mums nav īpašas izvēles. Bet tas nekādi nenosaka to, ka komentārus, kas nav kods, bet ir lirisks koda apraksts, nevar/nevajag rakstīt mums vis ērtāk lietojamajā valodā.

Edited July 20, 2012 by codez

[Kavacky]

Šos vārdus izmanto ļoti valodas kontekstā, jo zarošanās konstrukciju mēs pierakstām ar angļu "ja" jeb "if" un "citādi" jeb "else".

 

Tulkot komentārus, kad vajag klasi izmantot citur, ir lieks darbs, ja var neko netulkot, bet uzreiz uzrakstīt universāli saprotamā valodā.

 

Kā arī - dažādu valodu izmantošana kodā un komentārus prasa tulkot galvā vislaik, kad tiek lasīti komentāri un atbilstošais kods, lai saistītu vienā valodā sauktus mainīgo ar to aprakstu citā valodā. Vienā valodā šī liekā procedūra atkrīt.

Edited July 20, 2012 by Kavacky

[codez]

Tad jau sql varbūt paskāls vēl kaut cik turās līdzi valodas kontekstam, jo angliski teikums būtu

if a is greater than b then call function exit.

if ($a>$b) {exit();}

Viens if nepadara 2. pēkšņi par kaut kādu angļu valodas teikumu.

Edited July 20, 2012 by codez

[y2ok]

Kavacky: Ja, Logo tagad kļūtu par populārāko valodu, un darbā tev prasītu šo valodu zināt, tu komentārus šai valodai arī rakstītu vāciski, par cik koda elementi sastāv no vācu valodas?

Edited July 20, 2012 by y2ok

[codez]

Kā arī - dažādu valodu izmantošana kodā un komentārus prasa tulkot galvā vislaik, kad tiek lasīti komentāri un atbilstošais kods, lai saistītu vienā valodā sauktus mainīgo ar to aprakstu citā valodā. Vienā valodā šī liekā procedūra atkrīt.

Kas liek tulkot nosaukumus. Es, piemēram, nosaukumus netulkoju. Ja mainīgo sauc $user, tad tas ir mainīgā nosaukums un ir pilnīgi normāli nosaukumus netulkot.

[spainis]

^^^

Tad komentārs ir aptuveni šāds : Pārbaudām $user statusu, lai pārliecinātos, ka viņš ir pilnvarojies sistēmā?

[y2ok]

Nē, tas ir - Pārbaudām lietotāja statusu, lai pārliecinātos, ka viņš ir pilnvarojies sistēmā.

[spainis]

tātad mēs tomēr tulkojam biznesa objektu nosaukumus

 

un ja tagad būtu divi mainīgie $member un $user, kam būtu vajadzīgs komentārs, kā šos objektus nosaukt?

[y2ok]

User - Lietotājs, member - biedrs. Mēs netulkojam, vienkārši paskaidrojam latviski, ko funkcija dara!

 

[marrtins]

Tas nav acīmredzami?

[spainis]

User - Lietotājs, member - biedrs. Mēs netulkojam, vienkārši paskaidrojam latviski, ko funkcija dara!

 

un ja kāds tomēr ir izdomājis, ka member jātulko kā lietotājs?

 

un vispār fuck it, I have already given too much fuck

Edited July 20, 2012 by spainis

[codez]

Ja mēs runājam par lietotāju kā aplikācijas lietotāju, tad saucam viņu par lietotāju, ja mēs runājam konkrēti par mainīgo $user, tad to saucam par $user. Ja mums ir 2 mainīgie $user un $member, tad tos tā arī saucam, ja mums ir kaut kādas kādas vairākas loģiskas vienības, tad atkarībā no konteksta tās tā arī saucam, piemēram

class user{
 /**
 *  Nosūtīt ziņu lietotājiem no šī lietotāja.
 *
 *  @param array $users Masīvs ar lietotāju id, kuriem sūtīt ziņu. Lietotāju id, kuri neeksistēs, tiks ignorēti.
 *  @param string $text Ziņas saturs. Tiek eskeipots funkcijā.
 */
 function sendMessage($users, $text){
 }
}

Kādas problēmas?