This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
administrativ:barem_teme [2018/11/26 22:22] Adriana Draghici [Depunctări generale pentru teme] |
administrativ:barem_teme [2018/11/26 22:33] (current) Adriana Draghici [Depunctări generale pentru teme] |
||
|---|---|---|---|
| Line 36: | Line 36: | ||
| Vom aplica mici depunctări legate de calitatea codului și a abordărilor temelor. Din 10 puncte: | Vom aplica mici depunctări legate de calitatea codului și a abordărilor temelor. Din 10 puncte: | ||
| - | * -0.2 warning-uri de compilare | + | **Coding style si organizare:** |
| + | * -0.1 - cod înghesuit sau prea spațiat | ||
| + | * -0.2 - warning-uri de compilare | ||
| * verificați import-urile, variabilele nefolosite, etc | * verificați import-urile, variabilele nefolosite, etc | ||
| - | * -0.5 cod duplicat | ||
| - | * -0.1 cod înghesuit sau prea spațiat | ||
| - | * (variabil, începând de la -0.1) hardcodări | ||
| - | * folosiți constante în locul valorilor numerice/String-urilor literali | ||
| - | * -0.1 - metode șau variabile nefolosite | ||
| - | * între -0.1 și -0.5 - metode lungi (> 100 de linii) care ar fi putut fi sparte, bucăți mari de logică în main etc | ||
| - | * -0.1 - bucăți de cod comentat | ||
| - | * între -0.1 și -0.5 - comentarii absente sau irelevante | ||
| - | * -0.1 - comentarii de tip TODO în cod | ||
| - | * -0.1 - print-uri prin cod | ||
| * între -0.1 și -0.4 - nepăstrarea consistenței pentru comentarii - fie sunt toate comentariile în engleză fie sunt toate în română. | * între -0.1 și -0.4 - nepăstrarea consistenței pentru comentarii - fie sunt toate comentariile în engleză fie sunt toate în română. | ||
| * între -0.1 și -0.4 - nepăstrarea consistenței pentru denumiri - fie sunt toate n engleză fie în română. Puteți avea însă denumirile și comentariile în limbi diferite. | * între -0.1 și -0.4 - nepăstrarea consistenței pentru denumiri - fie sunt toate n engleză fie în română. Puteți avea însă denumirile și comentariile în limbi diferite. | ||
| * între -0.1 și -0.3 - denumiri nepotrivite pentru metode, variabile, clase | * între -0.1 și -0.3 - denumiri nepotrivite pentru metode, variabile, clase | ||
| + | * -0.1 - bucăți de cod comentat | ||
| + | * -0.5 - toate clasele intr-un singur fisier | ||
| + | * -0.3 - toate sursele puse intr-un pachet | ||
| + | * -0.1 - includerea altor fișiere care nu au legătură cu cerința | ||
| + | * -0.1 - includere folder bin in arhivă | ||
| + | |||
| + | **Documentare:** | ||
| + | * între -0.1 și -0.5 - comentarii absente sau irelevante | ||
| + | * -0.1 - comentarii de tip TODO în cod | ||
| + | * (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. Această depunctare nu se va aplica dacă pentru o anume temă nu este necesară exportarea de documente Javadoc. | ||
| * (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 | ||
| + | |||
| + | **Design, implementare:** | ||
| + | * -0.5 - cod duplicat | ||
| + | * între -0.1 și -0.3 hardcodări | ||
| + | * folosiți constante în locul valorilor numerice/String-urilor literali | ||
| + | * -0.1 - metode șau variabile nefolosite | ||
| + | * între -0.1 și -0.5 - metode lungi (> 100 de linii) care ar fi putut fi sparte, bucăți mari de logică în main etc | ||
| + | * -0.1 - print-uri prin cod | ||
| * între -0.2 și -0.5 - ruperea încapsulării | * între -0.2 și -0.5 - ruperea încapsulării | ||
| * între -0.2 și -0.5 - modificatori de acces folositi necorespunzator (e.g. metode lăsate publice care de fapt ar trebui să fie private) | * între -0.2 și -0.5 - modificatori de acces folositi necorespunzator (e.g. metode lăsate publice care de fapt ar trebui să fie private) | ||
| - | * -0.1 instanceof-uri și teste de tip in situații în care putea fi folosit polimorfismul | + | * -0.1 - instanceof-uri și teste de tip in situații în care putea fi folosit polimorfismul |
| - | * -0.5 folosirea tipurilor "raw" în loc de tipurile parametrice (generic) e.g. ''new ArrayList()'' în loc de ''new ArrayList<String>()'' | + | * -0.5 - folosirea tipurilor "raw" în loc de tipurile parametrice (generic) e.g. ''new ArrayList()'' în loc de ''new ArrayList<String>()'' |
| - | * (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. 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.5 toate clasele intr-un singur fisier | ||
| - | * -0.3 toate sursele puse intr-un pachet | ||
| - | * -0.1 includerea altor fișiere care nu au legătură cu cerința | ||
| - | * -0.1 includere folder bin in arhivă | ||
| - | |||
| 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. | ||