msb-public
/
Web-Dev-For-Beginners
mirror of https://github.com/microsoft/Web-Dev-For-Beginners.git
1
0
Code Issues Projects Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '7c95fe5e57'
${ noResults }
Web-Dev-For-Beginners/translations/hr/6-space-game/3-moving-elements-around/assignment.md

2.7 KiB
Raw Blame History

Komentirajte svoj kod

Upute

Čist, dobro dokumentiran kod ključan je za održavanje i dijeljenje vaših projekata. U ovom zadatku vježbat ćete jednu od najvažnijih navika profesionalnih programera: pisanje jasnih, korisnih komentara koji objašnjavaju svrhu i funkcionalnost vašeg koda.

Pregledajte svoj trenutni app.js datoteku u mapi igre i pronađite načine kako dodati komentare i urediti kod. Vrlo je lako da kod postane neorganiziran, a sada je dobra prilika da dodate komentare kako biste osigurali da imate čitljiv kod koji možete koristiti kasnije.

Vaš zadatak uključuje:

  • Dodavanje komentara koji objašnjavaju što radi svaki glavni dio koda
  • Dokumentiranje funkcija s jasnim opisima njihove svrhe i parametara
  • Organiziranje koda u logičke blokove s naslovima sekcija
  • Uklanjanje bilo kojeg neiskorištenog ili suvišnog koda
  • Korištenje dosljednih konvencija imenovanja za varijable i funkcije

Rubrika

Kriterij Izvrsno Zadovoljavajuće Potrebno poboljšanje
Dokumentacija koda Kod u app.js datoteci je u potpunosti komentiran s jasnim, korisnim objašnjenjima za sve glavne sekcije i funkcije Kod u app.js datoteci je adekvatno komentiran s osnovnim objašnjenjima za većinu sekcija Kod u app.js datoteci ima minimalno komentara i nedostaju jasna objašnjenja
Organizacija koda Kod je organiziran u logičke blokove s jasnim naslovima sekcija i dosljednom strukturom Kod ima određenu organizaciju s osnovnim grupiranjem povezane funkcionalnosti Kod je pomalo neorganiziran i teško ga je pratiti
Kvaliteta koda Sve varijable i funkcije koriste opisna imena, nema neiskorištenog koda, slijedi dosljedne konvencije Većina koda slijedi dobre prakse imenovanja s minimalno neiskorištenog koda Imena varijabli su nejasna, sadrži neiskorišteni kod, nedosljedan stil

Odricanje od odgovornosti:
Ovaj dokument je preveden pomoću AI usluge za prevođenje Co-op Translator. Iako nastojimo osigurati točnost, imajte na umu da automatski prijevodi mogu sadržavati pogreške ili netočnosti. Izvorni dokument na izvornom jeziku treba smatrati autoritativnim izvorom. Za ključne informacije preporučuje se profesionalni prijevod od strane čovjeka. Ne preuzimamo odgovornost za nesporazume ili pogrešna tumačenja koja proizlaze iz korištenja ovog prijevoda.