Komentarze
do: PhpDoc – ułatwiajmy sobie i innym życie
Komentarze:
@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
odpowiedzUż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-
@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
- Kawa w kapsułkach idealna do biura
- Circular Monday: zrównoważona alternatywa dla szaleństwa Black Friday
- Jak Polacy radzą sobie z problemami finansowymi? Stres i nowe strategie oszczędzania
- Fałszywi kupujący na OLX i SMS od firmy kurierskiej - nowa metoda oszustwa
- Które sieci handlowe Polacy uznali za najbardziej prospołeczne w 2024 r.?
- Polsko-brytyjski startup Wordware, który zamienia język naturalny w działające systemy AI pozyskał 120 mln zł w rundzie seed
- Płatności zbliżeniowe na iPhone już dostępne w zegarkach Huawei Watch GT 5
- Jak wybrać torbę na siłownię? Najważniejsze wskazówki
- Skuteczne zarządzanie dzięki technologii Asana: Kompletny przewodnik
- Optymalizacja Google Ads jako klucz do sukcesu firm
- Obsługa prawna firm - jakie usługi warto rozważyć?
- Radca prawny od nieruchomości - jakie usługi oferuje?
- Przewodnik dla zabieganych kobiet: jak wybrać idealny rodzaj relaksu?
- Którędy taniej do Chorwacji? Opłaty drogowe i sposoby na oszczędność
- Niezawodne pompy głębinowe w najlepszych cenach
- Decyzja o nadaniu uprawnienia budowlane
- Automatyzacja i precyzja w planowaniu produkcji - jakie możliwości dają systemy APS?
- Praca w Niemczech w okresie świątecznym: jakie branże szukają pracowników?
- Najlepsza oferta telefonu na kartę - czyli jaka?
- Jak zaoszczędzić kupując w sklepie obuwniczym? Sprawdzone wskazówki
Pobieranie danych...
- Niezawodne pompy głębinowe w najlepszych cenach (0)
- Którędy taniej do Chorwacji? Opłaty drogowe i sposoby na oszczędność (0)
- Polsko-brytyjski startup Wordware, który zamienia język naturalny w działające systemy AI pozyskał 120 mln zł w rundzie seed (0)
- Decyzja o nadaniu uprawnienia budowlane (0)
- Fałszywi kupujący na OLX i SMS od firmy kurierskiej - nowa metoda oszustwa (0)
- Optymalizacja Google Ads jako klucz do sukcesu firm (0)
- Obsługa prawna firm - jakie usługi warto rozważyć? (0)
- Które sieci handlowe Polacy uznali za najbardziej prospołeczne w 2024 r.? (0)
- Płatności zbliżeniowe na iPhone już dostępne w zegarkach Huawei Watch GT 5 (0)
- Radca prawny od nieruchomości - jakie usługi oferuje? (0)
- Jak wybrać torbę na siłownię? Najważniejsze wskazówki (0)
- Circular Monday: zrównoważona alternatywa dla szaleństwa Black Friday (0)
- Jak Polacy radzą sobie z problemami finansowymi? Stres i nowe strategie oszczędzania (0)
