This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
administrativ:barem_teme [2015/10/03 14:55] Adriana Draghici |
administrativ:barem_teme [2017/11/27 19:58] Adriana Draghici [Depunctări generale pentru teme] |
||
---|---|---|---|
Line 11: | Line 11: | ||
* Alocați suficient timp temelor. E improbabil ca o rezolvare într-un all-night coding sprint să fie de calitate. | * Alocați suficient timp temelor. E improbabil ca o rezolvare într-un all-night coding sprint să fie de calitate. | ||
* Nu scrieți codul din prima, ci alocați timp abordării și design-ului. | * Nu scrieți codul din prima, ci alocați timp abordării și design-ului. | ||
- | * Fiți consecvenți unui coding style [TODO link]. | + | * Fiți consecvenți unui [[administrativ:coding_style_ide|coding style]]. |
* Când scrieți README-ul pentru teme: | * Când scrieți README-ul pentru teme: | ||
* nu reproduceți cerințele din enunț și/sau comentariile din cod | * nu reproduceți cerințele din enunț și/sau comentariile din cod | ||
Line 39: | Line 39: | ||
* -0.2 warning-uri de compilare | * -0.2 warning-uri de compilare | ||
* verificați import-urile, variabilele nefolosite, etc | * verificați import-urile, variabilele nefolosite, etc | ||
- | * -0.2 linii mai lungi de 80 de caractere | ||
- | * formatați-vă codul să fie ușor de citit și parcurs | ||
- | * puteți folosi auto-formatter-ul IDE-ului pe care îl folosiți | ||
* (variabil începând de la -0.1) cod duplicat | * (variabil începând de la -0.1) cod duplicat | ||
* -0.1 cod înghesuit sau prea spațiat | * -0.1 cod înghesuit sau prea spațiat | ||
Line 52: | Line 49: | ||
* -0.1 metode lungi (> 150 de linii) în situații în care ar putea fi mai scurte | * -0.1 metode lungi (> 150 de linii) în situații în care ar putea fi mai scurte | ||
* (variabil, începând de la -0.2) metode kilometrice (> 300 de linii), bucăți mari de logică în main etc | * (variabil, începând de la -0.2) metode kilometrice (> 300 de linii), bucăți mari de logică în main etc | ||
- | * -0.1 cod comentat | + | * -0.1 bucăți de cod comentat |
- | * -0.2 comentarii absente sau irelevante | + | * (variabil, începând de la -0.1) comentarii absente sau irelevante |
- | * -0.1 denumire nepotrivită pentru metode, variabile, clase | + | * (variabil, începând de la -0.1) denumiri nepotrivite pentru metode, variabile, clase |
* (variabil, în funcție de alocarea punctajului fiecărei teme) Readme necorespunzător, lipsă, conținut irelevant, etc | * (variabil, în funcție de alocarea punctajului fiecărei teme) Readme necorespunzător, lipsă, conținut irelevant, etc | ||
* (variabil, începând de la -0.1) ruperea încapsulării, folosirea incorectă a modificatorilor de acces | * (variabil, începând de la -0.1) ruperea încapsulării, folosirea incorectă a modificatorilor de acces | ||
Line 60: | Line 57: | ||
* folosiți polimorfismul în schimb | * folosiți polimorfismul în schimb | ||
* (variabil, începând de la -0.2) Javadoc necorespunzător, incomplet, irelevant; inclus și documentarea lipsă sau incorectă a parametrilor metodelor | * (variabil, începând de la -0.2) Javadoc necorespunzător, incomplet, irelevant; inclus și documentarea lipsă sau incorectă a parametrilor metodelor | ||
- | * -0.1 lipsă Javadoc generat sau script de generare | + | * -0.1 lipsă Javadoc generat sau script de generare. Această depunctare nu se va aplica dacă pentru o anume temă nu este necesară exportarea de documente Javadoc. |
* (variabil, -0.2 până la -2 sau peste) design rigid, greoi, inextensibil, bug-prone | * (variabil, -0.2 până la -2 sau peste) design rigid, greoi, inextensibil, bug-prone | ||
* -0.1 folosirea tipurilor "raw" în loc de tipurile parametrice (generic) e.g. ''new ArrayList()'' în loc de ''new ArrayList<String>()'' | * -0.1 folosirea tipurilor "raw" în loc de tipurile parametrice (generic) e.g. ''new ArrayList()'' în loc de ''new ArrayList<String>()'' | ||
Lista nu este exhaustivă. Evaluatorii pot aplica depunctări mai mari decât cele prezentate aici, în funcție de numărul de apariții ale greșelilor sau de gravitatea lor. | Lista nu este exhaustivă. Evaluatorii pot aplica depunctări mai mari decât cele prezentate aici, în funcție de numărul de apariții ale greșelilor sau de gravitatea lor. |