Witam, jak piszecie komentarze w kodzie: po polsku czy po angielsku?
0
0
po polsku kaman ;)
0
Nie ma wersji MIX polskawo-angielskawej ;).
Poza tym pisanie komentarzy jest be, passé, démodé jak mówią książki typu "Czysty kod" (oczywiście trzeba tu kierować się zdrowym rozsądkiem i "kulturą" organizacji, w której się pracuje).
0
Mi komentarze służą głównie do rysowania separatorów z tytułami grup. Ale tytuły są po angielsku. ;)
0
The best comment is no comment.
Ps: polecam przeczytać Clean Code
0
Ja korzystam z pre-ide, gdzie człowiek nie ma prawa zarządzać ręcznie zawartością pliku, wszystko jest opakowane w wyższy poziom, a interpretując metadane wyższego poziomu generuje zwykły kod, po którym reszta przebiega normalnie.
Komentarze można dawać wielojęzyczne, ogólnie to jest tyle opcji, że nie ma co zostawać w tyle.
Wszystko jest schludne i ładne.
0
Zależy, projekty firmowe/komercyjne po angielsku, We własnych po polsku.
0
Ja zakładam, ze nigdy nie wiem kto będzie czytał mój kod, wiec pisze po ang.
3
Ja jedynie komentuje... fragmenty kodu którego nie używam. Ahahahahaha, nie powstrzymacie mnie!
2
Trzeba rozróżnić 2 rzeczy:
- komentarze - ich powinno być mało i powinny tłumaczyć dlaczego coś robimy
- dokumentację (często w formie bloków komentarza) - ich powinno być dużo i powinny tłumaczyć jak tego używać
Natomiast (prawie) nigdy nie powinno się pisać w komentarzach co robi dany kod.
Jednak co do pytania, to oba zawsze po angielsku
2
Niejednokrotnie przeglądałem cudze kody i miałem problem, bo ktoś wpadł na genialny pomysł pisania komentarzy np. po hiszpańsku. Już bym wolał kulawy angielski, bo przynajmniej dałoby się zrozumieć sens bez używania translatorów. Dlatego nikomu, nigdzie i nigdy nie polecam pisania ani kodu, ani komentarzy, w języku innym niż angielski.
Co innego, gdy komentarze napisane są w dwóch językach – np. angielskim (podstawowy) i ruskim.
4
ja już kiedyś wrzucałem na mikro, ale myślę, że to po części pokazuje skalę obrażeń
0
Jeżeli już trzeba to w firmowym sofcie piszę komcie po polsku. Tu akurat zależy to od całego zespołu. Wiem, że ok połowa programistów w firmie nie zna angielskiego. ;-) I wiem, że komentarz po ang ominą zamiast spróbować to tłumaczyć.
W swoim sofcie tylko angielski.
0
Kiedyś na SO dodałem post dotyczący Pythona, gdzie wszystko było pisane po polsku i otrzymałem odpowiedź, że zrobienie code review na 15 linijkach jest zbyt trudne ze względu na nieczytelność (nasz język nie jest aż taki łatwy jak nam się wydaje :P) - lepiej wszystko trzymać w angielskim ;)