Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
lfa:2023:proiect_coding_style [2023/11/27 17:29] tpruteanu |
lfa:2023:proiect_coding_style [2024/10/29 12:51] (current) cata_chiru |
||
|---|---|---|---|
| Line 19: | Line 19: | ||
| ====== Ce inseamna scorurile? ====== | ====== Ce inseamna scorurile? ====== | ||
| - | Ce incercam noi sa surprindem prin aceste metrici este complexitatea codului scris. Ele sunt impartite in mai multe scoreuri pentru a va ajuta sa detectati mai usor unde sunt probleme. | + | Ce incercam noi sa surprindem prin aceste metrici este complexitatea codului scris. Ele sunt impartite in mai multe scoruri pentru a va ajuta sa detectati mai usor unde sunt probleme. |
| - | In general, cu cat score-ul este mai mic, cu atat codul vostru este mai complex (valorile pot ajunge si negative). | + | In general, cu cat scorul este mai mic, cu atat codul vostru este mai complex (valorile pot ajunge si negative). |
| Orice scor peste 5 este desirabil, inseamna ca calitatea codul este **"peste medie"**. | Orice scor peste 5 este desirabil, inseamna ca calitatea codul este **"peste medie"**. | ||
| Line 38: | Line 38: | ||
| # ar fi echivalent cu un return, if-ul e redundant | # ar fi echivalent cu un return, if-ul e redundant | ||
| - | |||
| - | return cond | ||
| if {special_case}: | if {special_case}: | ||
| Line 59: | Line 57: | ||
| * Linii goale, spatierea nu are **NICIUN** efect asupra complexitati, chiar poate ajuta sa faca un cod mai usor de citit. | * Linii goale, spatierea nu are **NICIUN** efect asupra complexitati, chiar poate ajuta sa faca un cod mai usor de citit. | ||
| * Comentariile nu afecteaza in niciun fel scorul primit. | * Comentariile nu afecteaza in niciun fel scorul primit. | ||
| - | * Numele variabilelor, ''x'' nu e un nume mai bun ca ''variabila_foarte_lunga_si_explicita'', ele sunt echivalente in contextul metricilor folosite. Deobicei chiar sunt preferate variabilele cu nume mai lungi si explicite. | + | * Numele variabilelor, ''x'' nu e un nume mai bun ca ''variabila_foarte_lunga_si_explicita'', ele sunt echivalente in contextul metricilor folosite. De obicei chiar sunt preferate variabilele cu nume mai lungi si explicite. |
| ====== Note specifice ====== | ====== Note specifice ====== | ||
| - | * La etapa 1, scorul global cu include functiile de ''remap_states'', atat din ''DFA'' cat si din ''NFA'', orice faci in aceasta functie nu contribuie la scor, pentru ca cerinta era optionala. | + | * La etapa 1, scorul global nu include functiile de ''remap_states'', atat din ''DFA'' cat si din ''NFA'', orice faci in aceasta functie nu contribuie la scor, pentru ca cerinta era optionala. |
| - | * Un scor global foarte mic, dar scoruri extrem bune pe functii deobicei inseamna ca ati folosit functii auxiliare pentru majoritatea implementari. Asta nu e ceva rau, dar daca scorul global este mic, e posibil ca aceste functii auxiliare sa fie prea complexe. Pentru a localiza putin punctajul sa va dati seama unde sunt probleme puteti sa faceti functiile auxiliare functii locale pentru ''accept'' si ''subset_construction'', astfel o sa fie luate in calcul la complexitatea celor doua functii si puteti sa va dati seama care set de functii auxiliare era prea complex, sau daca erau amandoua. | + | * Un scor global foarte mic, dar scoruri extrem bune pe functii de obicei inseamna ca ati folosit functii auxiliare pentru majoritatea implementari. Asta nu e ceva rau, dar daca scorul global este mic, e posibil ca aceste functii auxiliare sa fie prea complexe. Pentru a localiza putin punctajul sa va dati seama unde sunt probleme puteti sa faceti functiile auxiliare functii locale pentru ''accept'' si ''subset_construction'', astfel o sa fie luate in calcul la complexitatea celor doua functii si puteti sa va dati seama care set de functii auxiliare era prea complex, sau daca erau amandoua. |
| <note> | <note> | ||
| Daca arhiva contine si altceva pe langa folderul ''src'', e posibil ca scorul global sa fie tras in jos de codul din teste sau orice altceva ati uploadat, trimiteti doar codul necesar | Daca arhiva contine si altceva pe langa folderul ''src'', e posibil ca scorul global sa fie tras in jos de codul din teste sau orice altceva ati uploadat, trimiteti doar codul necesar | ||
| </note> | </note> | ||