Vardai ir doc komentarai

Įrankiai sutvarko formą; vardus ir paaiškinimus tvarkai tu.

Vardai — MixedCaps. Go stilius: pagesPerDay, listItems, formatItem. Ne pages_per_day (Python stilius), ne PAGES_PER_DAY. Trumpi vardai trumpoms gyvenimo trukmėms (i, it cikle), aiškūs vardai funkcijoms.

Doc komentaras — sakinys virš funkcijos ar tipo, prasidedantis jos vardu:

// listItems prints every item, numbered.
func listItems(items []Item) {

Palygink su komentaru-triukšmu: // funkcija spausdinimui — nieko neprideda. Doc komentaras atsako „ką ir kam", ne „kad yra". Mūsų pavyzdinėse programose juos matai nuo 3 pamokos — dabar žinai, kodėl.

O dabar — Go griežtumo perliukas:

Spąstai. Nenaudojamas importas ar kintamasis Go kalboje — ne įspėjimas, o kompiliavimo klaida:

imported and not used: "strconv"
declared and not used: title

Iš kitų kalbų atėjusius tai šokiruoja: „kodėl neleidžia PALEISTI?!" Priežastis paprasta — nenaudojamas kodas meluoja skaitytojui. Ištrynei šaką, kuri naudojo strconv? Ištrink ir importą (arba leisk gofmt-o broliui goimports tai padaryti). Laikinam „dar prireiks" atvejui yra _ = title triukas, bet jis turi likti laikinas.