[so] [Tema 1][General] Sfaturi Coding Style

[Ioan-Florin-Cătălin NIŢU (87674)]

Salut,

Am câteva nelămuriri și întrebări legate de coding style:

1. Am vazut că în headerul cu funcția compare se folosea #ifndef __COMPARE_H_, așa că pentru consecvență si eu mi-am făcut la fel define-urile pentru bibliotecile mele (#ifndef __UTILS_H_ de exemplu), dar am citit că acest lucru nu e recomandat. Să schimb peste tot (să dau drop la __) sau să las așa?

2. Când știu ce funcții să fac statice? Și cum le organizez în headere? Dacă declar o funcție static trebuie să o scriu neaparat in header, dar eu nu vreau asta. In headere aș vrea să păstrez doar prototipul funcțiilor. Cum e recomandat sa lucrez?

3. În implementare am folosit ceva gen struct smt *s = malloc(sizeof(struct smt)); pot lasă așa sau o să fiu penalizat la notare? (nu aș schimba în tot codul să pun struct smt *s = malloc(sizeof(*s)); dar dacă e nevoie o fac).

4. In Kernel coding style am citit că e recomandat să se scrie despre fiecare variabila folosită câteva cuvinte, sper ca e okay daca am facut asta. Printre altele am pus și #endif /* __UTILS_H */ pentru include-uri, tot din recomandari.

5. Este okay dacă am folosit typedef pentru structuri? Știu că în documentația de la Kernel spune că nu e recomandat, dar având în vedere scopul temei mi s-a părut mai usor de înțeles/utilizat/lucra așa. Pe viitor am să fiu mai atent la abordare.

6. Este okay dacă scriu README-ul în română? (comentariile din cod le-am pus in engleză, dar aș prefera să scriu README-ul în română).

7. Deși nu are neapărat legătură cu coding style, dacă nu am lucrat pe git cu tema, pot să fac un repo simplu în care să pun doar sursele mele și atât? Sau să copiez repo-ul vostru și pentru fiecare temă să îmi mai fac eu un folder separat de fișierele voastre în care să îmi pun sursele și celelalte fișiere utile?

Intreb aceste lucruri pentru ca nu am erori de checkstyle care să mă ajute să imi rezolv singur problemele și aș vrea să scap de ambiguități.

Mulțumesc frumos și imi cer scuze de deranj. Știu că poate par puerile intrebările mele dar aș vrea să știu cum să procedez.

Seara frumoasa,

Cătălin
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://cursuri.cs.pub.ro/pipermail/so/attachments/20190312/182f2fbd/attachment.html>