Witam, jak piszecie komentarze w kodzie: po polsku czy po angielsku?
po polsku
kaman ;)
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).
Mi komentarze służą głównie do rysowania separatorów z tytułami grup. Ale tytuły są po angielsku. ;)
The best comment is no comment.
Ps: polecam przeczytać Clean Code
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.
Zależy, projekty firmowe/komercyjne po angielsku, We własnych po polsku.
Ja zakładam, ze nigdy nie wiem kto będzie czytał mój kod, wiec pisze po ang.
Ja jedynie komentuje... fragmenty kodu którego nie używam. Ahahahahaha, nie powstrzymacie mnie!
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
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.
ja już kiedyś wrzucałem na mikro, ale myślę, że to po części pokazuje skalę obrażeń
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.
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 ;)