Make your JavaScript projects more accessible to newcomers

Transcript

1. Pisanje blog posta Matija Maronhić Improvement Day
2. Pisanje
3. “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
4. “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
5. “Make your JavaScript projects more accessible to newcomers”
6. 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
7. Progressive disclosure • uzorak u interaktivnom dizajnu • zašto ne primijeniti nešto slično u DX-u? • postupno otkrivati logiku projekta
8. npm skripta
9. npm skripta
10. gulp task
11. Dokumentacija • dobre konvencije > dobra dokumentacija • automatizirati što je više moguće • out of sight, out of mind
12. Automatizacija dokumentacije
13. Automatizacija dokumentacije
14. Umjesto CONTRIBUTING.md • npm skripte (npr. prepublishOnly) • git hookovi • deskriptivni errori
15. Konvencije • lintanje pomoću pre-commit, commit-msg • verzija Yarna pomoću “engines” • minimizacija CONTRIBUTING.md
16. “DX Developer”? “Platform Developer”?