Apple Facebook Google Microsoft badania bezpieczeństwo patronat DI prawa autorskie serwisy społecznościowe smartfony

Komentarze

do: PhpDoc – ułatwiajmy sobie i innym życie

Dodaj nowy

Najnowsze

Wyróżnione

Śledź przez RSS

Komentarze:

DariuszP (15)

@hahaha,
przez chwilę myślałem że ktoś jakiś sensowny komentarz dodał :P
Jak piszesz do ogółu (bo nie wiesz kto taki tekst czytał będzie tutaj) to starasz się raczej nie używać języka obcego. Owszem, metodę nazwałem show(), komentarze mam po polsku (tak samo jak ten "Obiekt") ale głównie chodziło o to żeby każdy się w tym rozczytał.

Weź to od innej strony. Jak bym całość kodu napisał w języku Suahili (nazwy klas, zmiennych, komentarze itp) to jak by Ci się cały tekst czytało ?
Taka sama zasada panuje w sytuacji gdy kogoś zainteresował tekst a nie czuje się mocnym w angielskim.

Tak na marginesie wspomnę że spotkałem się już sytuacją gdzie całość kodu (nie licząc oczywiście elementów samego języka) była pisana po polsku. Przy okazji tam też nikt się dokumentacją nie przejmował :-) Mała grupa dobrych programistów którzy by Ci w nocy o północy wyjaśnili każdy element swojego systemu.

19-04-2011, 09:02

odpowiedz
thek (461)
[w odpowiedzi dla: ~hahaha]

Używanie polskich lub angielskich nazw to tylko konwencja programistyczna i jej używanie jest opcjonalne, tak samo zresztą jak stosowanie phpDoca. Stosowanie zresztą tej konwencji tyczy się zresztą głównie nazw klas, funkcji i zmiennych. Dla potrzeb ogólnych zapewne autor pisze po angielsku, ale na potrzeby poradnika tutaj - użył polskiego by nie musieć dublować się z opisem co jest czym i co robi lub do czego służy. tak więc jeśli chcesz juz coś wytykać, to niech to będzie konstruktywna krytyka, a nie czepianie się czegoś co de facto uchybieniem nie jest, ale ma służyć lepszej czytelności dla odbiorców artykułu.

18-04-2011, 09:20

odpowiedz
~hahaha

Autor to niech najpierw napisze artykuł o niemieszaniu polskich i angielskich nazw a potem zajmuje sie phpdocem

18-04-2011, 08:59

odpowiedz
~asd

@BaXx, to Ty chyba preferujesz "inne" OOP niż ja. OOP stosujemy właśnie po to by życie sobie ułatwiać.
Dziedziczenie, hermetyzacja czy polimorfizm daje szerokie pole do popisu.
No ale z OOP jak z młotkiem. Jest nieoceniony kiedy chcesz przybić gwoździa ale jak nie umiesz się nim posługiwać to tylko poobijasz sobie palce.
O samą dokumentację trzeba dbać zawsze i wszędzie.

16-04-2011, 16:05

odpowiedz
~BaXx

Zwłaszcza w OOP a szczególnie w 90% przypadków, kiedy jest niepotrzebnie angażowany trzeba dbac o dokumentację. gdyz taka metoda programowania nie jest deskryptywna i jest zagmatwana. Trzeba sie ratować dokumentacją, chociaz to niewiele ułatwia.

16-04-2011, 15:12

odpowiedz