Pse ekipet e vogla publikojnë udhëzues stili
Çfarë mësuam duke shkruar udhëzues stili publikë për SecureDrop, Briar dhe Reproducible Builds.

Përmbajtja7
Udhëzuesi i stilit duket si diçka që u duhet vetëm kompanive të mëdha. Përvoja jonë tregon të kundërtën. Disa nga udhëzuesit më të dobishëm që kemi bërë ishin për organizata të vogla dhe projekte me vullnetarë: SecureDrop për Freedom of the Press Foundation, aplikacionin e mesazheve të sigurta Briar dhe iniciativën Reproducible Builds.
Ajo që i bashkonte këto projekte nuk ishte madhësia. Ishte numri i njerëzve që prodhonin materiale pa qenë në të njëjtën dhomë.
Problemi janë shumë duar
Reproducible Builds mbahet nga kontribues vullnetarë. Para udhëzuesit, njerëzit përgatitnin prezantime, faqe dhe grafika pa një referencë vizuale të përbashkët, ndaj logot, fontet dhe komponentët e ndërfaqes ndryshonin nga një material te tjetri. Askush nuk po bënte gabim. Thjesht nuk kishin me se të krahasonin.
SecureDrop kishte një problem të ngjashëm në një shkallë tjetër. Është sistem për dërgimin e dokumenteve nga sinjalizuesit, që e instalojnë organizatat mediatike, dhe ekipi i çdo redaksie punon me instalimin e vet. Pa një referencë të qartë, çdo ekip rrezikonte të krijonte versionin e vet të markës. Për një produkt sigurie kjo ka rëndësi: një faqe që duket ndryshe nga ajo që presin njerëzit mund t’i bëjë të hezitojnë pikërisht në momentin e gabuar.
Çfarë përmban një udhëzues i dobishëm
Udhëzuesi i stilit nuk ka nevojë të ketë njëqind faqe. Ata që ndërtuam mbulojnë një grup të vogël vendimesh që njerëzit i marrin vazhdimisht:
- ngjyrat, me vlerat e shkruara
- tipografinë: cilat fonte, cilat madhësi dhe ku përdoret secila
- ikonat, gati për shkarkim
- komponentët e ndërfaqes si butonat, formularët dhe njoftimet
- logon dhe mënyrën si mund të përdoret
Qëllimi është t’i përgjigjet pyetjes që ka dikush në momentin kur po krijon diçka, që të mos ketë nevojë të hamendësojë ose të pyesë.
Tregoni shembuj që mund të kopjohen
Rregullat më vete zbatohen me vështirësi. Udhëzuesit e SecureDrop dhe Reproducible Builds përfshijnë shembuj të dokumentuar që kontribuesit mund t’i kopjojnë direkt në faqet e tyre. Një kontribues që ndërton një faqe të re nis nga një komponent që është tashmë i saktë, në vend që ta rindërtojë nga një pamje ekrani.
Publik dhe i lehtë
Këta udhëzues janë faqe publike në ueb, jo skedarë që qarkullojnë me email. Reproducible Builds e mban udhëzuesin nën domenin kryesor të iniciativës. Udhëzuesi i Briar është një faqe Hugo e publikuar në GitLab Pages. Kushdo mund ta gjejë versionin aktual, dhe ka vetëm një version aktual.
Udhëzuesi i SecureDrop funksionon edhe pa JavaScript. Lexuesit që i kushtojnë rëndësi sigurisë shpesh shfletojnë me skriptet të çaktivizuara, ndaj një referencë e shkruar për ta duhet ta respektojë këtë zgjedhje.
Ripërdorni një strukturë që funksionon
Kur krijuam udhëzuesin e Briar, strukturën e bazuam te udhëzuesi i SecureDrop. Të dy projektet kanë identitete të ndryshme, por pyetjet e kontribuesve janë të ngjashme, dhe një strukturë e njohur e bëri udhëzuesin e ri më të shpejtë për t’u ndërtuar dhe më të lehtë për t’u lundruar.
Udhëzuesi ka nevojë për një përgjegjës
Udhëzuesi i stilit është i dobishëm vetëm kur përputhet me produktin. Dikush duhet ta përditësojë kur ndryshon një ngjyrë ose shtohet një komponent i ri, dhe kontribuesit duhet të kenë një mënyrë për të sugjeruar ndryshime. Ndihmon ta mbani udhëzuesin në të njëjtën depo kodi me pjesën tjetër të projektit: një ndryshim në dizajn dhe një ndryshim në udhëzues mund të shqyrtohen bashkë.
A i duhet biznesit tuaj?
Nëse një person i dizajnon të gjitha, ndoshta jo ende. Nëse disa njerëz ose agjenci përgatitin materiale për ju, si postime në rrjetet sociale, prezantime, faqen e internetit dhe materiale të printuara, edhe një faqe e vetme me ngjyrat, fontet, skedarët e logos dhe disa shembuj do t’ju kursejë kohë dhe do t’i mbajë gjërat të njëtrajtshme.
Bazat e markës janë pjesë e përgatitjes para porosisë së një faqeje, ndërsa këta udhëzues i gjeni në portfolion tonë. Nëse ekipit tuaj i duhet një referencë e përbashkët, le të flasim.


