Style Guide

En stilguide är en dokumenterad uppsättning standarder som styr hur något ska produceras, och omfattar visuella element, skriftspråk eller båda. Visuella guider specificerar typografi, färg, avstånd, bildbehandling och logotypanvändning; innehållsguider specificerar ton, terminologi, versaler, formateringskonventioner och hur man hanterar återkommande fall som datum, siffror och felmeddelanden.

Dess syfte är att uppnå konsekvens utan att varje beslut behöver omprövas. Utan dokumenterade standarder produceras varje ny sida, kampanj eller skärm enligt bedömningen av den som byggde den, och en organisation ackumulerar ett dussin lite olika behandlingar av samma element. Kostnaden framträder som visuell inkonsekvens, som inkonsekvent terminologi som förvirrar kunder, och som tid som läggs på att diskutera beslut som fattades för flera år sedan.

De mest användbara guiderna är föreskrivande och specifika snarare än beskrivande och ambitiösa. Ett påstående att varumärkesrösten är vänlig men professionell ger ingen vägledning till någon som skriver ett felmeddelande. En guide som visar den föredragna och avvisade formuleringen för vanliga situationer, med angivna skäl, är direkt användbar. Testet är om en ny bidragsgivare skulle kunna producera ett arbete som uppfyller kraven enbart från dokumentet.

Terminologibeslut är ofta det mest värdefulla innehållet och det mest försummade. Att bestämma vad organisationen kallar varje produkt, funktion och process, och registrera de alternativ som inte bör användas, förhindrar situationen där marknadsföring, produkt, support och dokumentation använder olika ord för samma sak. Kunder som stöter på tre namn för ett koncept drar rimligen slutsatsen att de är tre olika saker.

Guider misslyckas främst på grund av bristande efterlevnad snarare än på grund av dåligt innehåll. Ett dokument som skrivs, cirkuleras och aldrig refereras till igen blir snabbt omkört av inkonsekvent praxis, och den version som folk faktiskt följer blir vad det senaste liknande arbetet såg ut som. Tillämpningsmekanismer som fungerar inkluderar att bädda in regler i verktyg, såsom att söka efter innehållsstandarder och begränsa val i design- och komponentbibliotek, vilket gör efterlevnad till minst motstånds väg.

Underhåll avgör om riktlinjerna förblir auktoritativa. Standarder som inte längre återspeglar aktuell praxis ignoreras selektivt, och selektiv efterlevnad blir generell bristande efterlevnad. Att tilldela ägarskap, tillhandahålla en väg för att föreslå ändringar och regelbunden granskning håller dokumentet aktuellt, och dokumentera resonemanget bakom beslut förhindrar att de upphävs i förbigående av någon som inte vet varför de fattades.

Omfattningen bör matcha vad organisationen realistiskt kan upprätthålla. Omfattande guider som täcker alla tänkbara fall blir tillräckligt omfattande för att ingen ska läsa dem och tillräckligt inaktuella för att ingen ska lita på dem. En koncis guide som täcker de beslut som faktiskt återkommer, utökad endast när en genuin tvetydighet uppstår upprepade gånger, förblir aktuell och används, och disciplinen att vägra dokumentera sällsynta fall är det som håller det så.

Förhållandet till ett designsystem är värt att särskilja. En stilguide dokumenterar beslut och regler; ett designsystem tillhandahåller implementerade komponenter som förkroppsligar dem. En guide är ensam beroende av att människor läser och tillämpar den, medan komponenter upprätthåller standarden automatiskt var de än används. Där båda finns täcker guiden vad komponenter inte kan, inklusive ton, terminologi och beslut som kräver bedömning.

Eftersom värdet kommer från implementering snarare än från dokumentation, ger ansträngningar som läggs på verkställighetsmekanismer vanligtvis mer avkastning än ansträngningar som läggs på att utöka guiden. I praktiken fastställs de visuella och komponentstandarderna inom produktdesign och kodade i designsystemet, är språk- och terminologistandarderna överenskomna med marknadsföringstjänster så att kundorienterat ordförråd är konsekvent över hela produkten och dess marknadsföring, och ägarskapet vanligtvis ligger hos UX-avdelningen där en sådan finns.