Zasady umieszczania postow z kodami

 
Napisz nowy tematOdpowiedz do tematu    Forum programistyczne Programmers Zone Strona Główna -> Java
Autor Wiadomość
progs
#Moderator




Dołączył: 16 Cze 2005
Posty: 6000
Skąd: 3m
Pomógł: 358

PostWysłany: 03-01-08 08:41 Zacytuj zaznaczone Odpowiedz z cytatem

Witam

Ostanio pojawia sie coraz czesciej kodow w ktorych nie sa zachowane zadne konwencje nazewnictwa, ciezko sie je analizuje i wygladaja jak "dupa za karzaka" dlatego postuluje o zachowanie ptzynajmniej minimum konwencji nazwenictwa:
- klasy nazywamy z duzej litery oddzielajac kazde slowo skladowe duza litera np:
TimerTask a nie timerTask czy TIMERtask
- metody nazywamy tak jak klasy z ta roznica ze pierwsza litera jest mala np:
updateData a nie UpdateData czy UpdateDATA
- stale piszemu literami drukowanymi oddzielajac slowa za pomoca "_" np:
EXIT_ON_CLOSE a nie exitOnClose czy ExitOnClose

To jest minimum jakie musi byc zachowane inaczaj beda ostrzezenia na poczatek na forum/PW potem juz oficjalne, stosowanie konwencji nie wymaga duzo wysilku a ulatwia wszytskim zycie.

Dodatkowo dobrze by bylo aby wklejane kody uwzglednialy setno problemu a nie cale klasy z kilkuset linijkami, dlatego tez radze prznosci problematyczny kod do osobnych klas testowych ktore prezentuja tylko i wylacznie problematyczny kod. Pozwoli to nam na szybka analize i odpowiedz.
Nie musze dodawac ze wklejany kod musi byc kompletny tzn. musi pozwolic sie uruchomic po wrzuceniu w IDE.

Nikt z nas nie ma czasu na analizowanie dlugasnych kodow bez konkretnego opisu co zle dziala lub jakie bledy powstaja.

Prosby o analize kompletnych kodow o duzej wielkosci prosze zamieszczac w postaci linkow do archiwum z kodem (oraz krotkim opisem co jest z nim nie tak), najlepiej w postaci projektu Eclipse lub NetBeans wraz z dolaczonymi bibliotekami dodatkowymi do projektu lub gotowymi plikami uruchomieniowymi typu BAT/SH.

pozdro.

_________________
Programowac kazdy moze, tylko nie kazdy ma tyle cierpliwosci i zapalu zeby zajac sie tym na poważnie:)


Ostatnio zmieniony przez progs dnia 24-07-09 11:25, w całości zmieniany 2 razy
Powrót do góry
Zobacz profil autora Wyślij prywatną wiadomość Wyślij email Odwiedź stronę autora Numer GG Tlen
Chester
#Moderator




Dołączył: 26 Maj 2005
Posty: 1434
Skąd: Wa-wa
Pomógł: 37

PostWysłany: 14-04-08 15:28 Zacytuj zaznaczone Odpowiedz z cytatem

To i ja dorzuce jeszcze cos od siebie. Niby oczywiste, a czesto sa z tym problemy...

Kody źródłowe zamieszczamy w znaczniku SYNTAX a nie CODE

_________________
1. Mod nie spamuje - on ma wiele do przekazania
2. Mod nie myli się - on ma inne zdanie
3. Mod nie obija się - on czuwa
4. Mod nie rozmywa tematu - on przypomina o innych ważnych sprawach
5. Mod nie obraża innych - on dobitnie zwraca uwagę
6. Mod nie flooduje - on ekspresywnie wyraża swoje myśli
7. Mod nie zakłada głupich tematów - on sprawdza czujność forumowiczów
8. Kto przychodzi ze swoimi przekonaniami - wychodzi z przekonaniami moda
9. Szanuj moda swego - możesz mieć gorszego
Powrót do góry
Zobacz profil autora Wyślij prywatną wiadomość Wyślij email Numer GG Jabber
Wyświetl posty z ostatnich:   
Napisz nowy tematOdpowiedz do tematu    Forum programistyczne Programmers Zone Strona Główna -> Java Wszystkie czasy w strefie EET (Europa)
Strona 1 z 1

 
Skocz do:  
Nie możesz pisać nowych tematów
Nie możesz odpowiadać w tematach
Nie możesz zmieniać swoich postów
Nie możesz usuwać swoich postów
Nie możesz głosować w ankietach

Mapa
Powered by phpBB © 2001, 2005 phpBB Group

 Polecane strony