Pisanje blog posta
Matija Maronhić
Improvement Day
Slide 2
Slide 2 text
Pisanje
Slide 3
Slide 3 text
“Ne znam dobro engleski ”
• Andrey Sitnik (PostCSS, Autoprefixer itd.)
• 5 gramatičkih pogreški u svakoj rečenici
• nikoga nije briga jer radi zakon stvari
Slide 4
Slide 4 text
“O čemu da pišem?”
• o tome što si naučio prošli tjedan
• ja sam napisao blog post o tome kako se riješiti moljaca
• nijedan blog post nije previše kratak ili previše osnovan
Slide 5
Slide 5 text
“Make your JavaScript projects
more accessible to newcomers”
Slide 6
Slide 6 text
Developer experience (DX)
• ljudi dolaze i odlaze iz projekta i firme
• dobar DX čini projekte fleksibilnijima
• zbog lošeg DX-a se ljudi koji se tek zagrijavaju mogu osjećati
zapostavljeno ili neadekvatno
• ali mnogi developeri mrze raditi na tome
Slide 7
Slide 7 text
Progressive disclosure
• uzorak u interaktivnom dizajnu
• zašto ne primijeniti nešto slično u DX-u?
• postupno otkrivati logiku projekta
Slide 8
Slide 8 text
npm skripta
Slide 9
Slide 9 text
npm skripta
Slide 10
Slide 10 text
gulp task
Slide 11
Slide 11 text
Dokumentacija
• dobre konvencije > dobra dokumentacija
• automatizirati što je više moguće
• out of sight, out of mind
Slide 12
Slide 12 text
Automatizacija dokumentacije
Slide 13
Slide 13 text
Automatizacija dokumentacije
Slide 14
Slide 14 text
Umjesto CONTRIBUTING.md
• npm skripte (npr. prepublishOnly)
• git hookovi
• deskriptivni errori
Slide 15
Slide 15 text
Konvencije
• lintanje pomoću pre-commit, commit-msg
• verzija Yarna pomoću “engines”
• minimizacija CONTRIBUTING.md