Hvordan få webdesigndokumentasjon til å suge mindre

Innhold

• 1. Gi UX-dokumentasjonen din formål
• 2. Gjør UX-dokumentasjonen nyttig
• 03. Gjør UX-dokumentasjonen din brukbar
• Dokumentasjon er ikke et papirspor

Mellom forskning, design, klientinteraksjon og teamsamarbeid, er det kanskje ikke mye tid igjen for en UX-spesialist til å tenke på å lage webdesigndokumentasjon strategisk.

Er det til og med verdt å bruke tid på å perfeksjonere UX-dokumentasjon? Vel ja og nei. Det avhenger av formålet og bruken av dokumentasjonen. For eksempel er generalisert dokumentasjon, laget uten annen grunn enn å legge igjen en papirspor, for generell til å være nyttig og (effektivt) formålsløs. Høyt fokusert dokumentasjon kan derimot være både nyttig og målrettet.

For å sikre at dokumentasjonen du lager ikke tar bort tid som kan brukes bedre på design og forskning, bør du vurdere følgende spørsmål:

• Kommer UX-dokumentasjonen til å føre beslutningsprosesser?
• Er UX-dokumentasjonen din brukbar av teamet ditt?

Her presenterer vi en tretrinns plan for å gjøre UX-designdokumentasjonen din så nyttig som mulig.

1. Gi UX-dokumentasjonen din formål

UX-dokumentasjon har formål hvis den driver beslutninger. UX-dokumentasjon har et bredt utvalg av sluttbrukere - inkludert designere, utviklere, QA-spesialister, interessenter og ledere. Alle disse menneskene kan bruke et bestemt dokument for å ta informerte beslutninger i løpet av arbeidet.

Et bestemt dokument kan påvirke en bestemt aktivitet i Agile Software Development Lifecycle (SDLC), mens et annet dokument kan påvirke en rekke påfølgende aktiviteter. Så det er ekstremt viktig å ta i betraktning livssyklusen til dokumentet - hvilken vei vil det ta, fra bruker til bruker, før det ikke lenger er behov for det?

Det er et spørsmål om avkastning. Generelt, jo lenger et dokument forblir relevant, jo større er avkastningen på tiden som brukes til å perfeksjonere det. UX-spesialister trenger bare å lage dokumentasjon der det virkelig er behov for det. Ellers kaster du bort tid og penger.

Dokumentets livssyklus

Du lurer kanskje på hvordan det er mulig å bestemme livssyklusen til et dokument før du til og med har laget det. Vel, det er så enkelt som å se på dokumentets forskjellige bruksområder. Ta for eksempel følgende empatikart.

La oss undersøke livssyklusen til det ovennevnte empatikartet, med tanke på hvem som sannsynligvis vil bruke dokumentet, og til hva.I dette tilfellet er det aktuelle dokumentet en samling av brukerforskningsresultater.

Brukerundersøkelsesresultater driver hele produktstrategien i løpet av programvarens utviklingslivssyklus. Selv om utviklere og PM-er ikke eier dokumentet, vil innsikten uunngåelig påvirke deres arbeid.

Hvis vi følger logikken som ble presentert tidligere, er et empatikart en utrolig investering i produktets fremtid. Det er et dokument som det alltid er verdt å lage - og jo tidligere, jo bedre.

2. Gjør UX-dokumentasjonen nyttig

Et dokument kan føre til beslutningstaking, men samtidig være ubrukelig. Utviklere har ikke alltid like mye å si for hvordan de skal legge ut en bestemt side - de kan bare følge designene laget av UX- og UI-designerne. Dermed vil designdokumentasjonen, uansett hvor dårlig den måtte være, føre til utviklingsbeslutninger.

Med andre ord er 'kjørebeslutninger' ett begrep, og 'å kjøre gode beslutninger' er noe annet helt. Når du husker at dokumentasjon ikke bare har et formål, men også en målgruppe, vil det sannsynligvis bidra til å stimulere god beslutningstaking blant målrettede brukere.

Det motsatte er også sant. Dokumentasjon som ikke tar hensyn til publikums spesifikke krav, kan mislykkes med UX-spesialistens intensjoner.

Å unngå fallgruvene i ikke-målrettet dokumentasjon er enkelt:

1. Bestem målbrukerbasen
2. Analyser hvordan dokumentet skal brukes
3. Lag dokumentet slik at det snakker brukerens språk

Vurder denne interaktive trådrammen. Du kan bestemme målbrukerne for ethvert dokument ved å undersøke formålet. Statiske wireframes brukes vanligvis som visuelle stillas, slik at grensesnittdesigneren kan lage en piksel-perfekt mockup av UX-designerens visjon.

Interaktive trådrammer har imidlertid et bredere publikum. De kan brukes av utviklere til å måle avhengigheter og interaksjonsmodeller. Produktledere kan bruke dem til raskt å vurdere funksjonsbredden og dybden. QA-spesialister kan til og med bruke den interaktive trådrammen til å dobbeltsjekke utviklerens arbeid når de gjenskaper funksjonaliteten.

Som sådan inkluderer målgruppen for en interaktiv trådramme UI-designere, produktledere, web- / mobilutviklere og QA-spesialister. For å sikre at dokumentet er nyttig, må det imøtekomme de spesifikke behovene til hver av disse brukerne.

Som vist i den kommenterte prototypen ovenfor, her er hvordan du raskt kan skreddersy dokumentet til hvert publikum.

• UI-designere: Beregn dimensjoner for bilde og layout
• Produktledere: Legg merke til eventuelle "wobbler" -funksjoner som kan gi ekstra verdi, men som overskrider gjeldende omfang
• Utviklere: Legg til notater for å avklare kompleks funksjonalitet og be om innspill om gjennomførbarhet
• QA-spesialister: Legg merke til hvilken funksjonalitet som er diskutert, og som teamet godtar

03. Gjør UX-dokumentasjonen din brukbar

Dokumentasjon, som programvare, avhenger sterkt av brukervennlighet. Uansett hvor mye godt innhold du tar med i dokumentasjonen, er det for ingenting hvis leseren sliter med å forstå det. For å forbedre dokumentbrukbarheten, trenger du fokus.

Ofte har UX-spesialister så mye å si om arbeidet sitt at det kommer i veien for dataene som må kommuniseres. Dette kan være kilden til mange problemer, spesielt når dataene går tapt i oversettelsen.

Mennesker liker ikke å lese fremmede detaljer. Hvor mange ganger i livet ditt har du vært begeistret for å lese et dokument på 20-30 sider? Du må holde det fokusert.

Ta for eksempel områdekartet ovenfor, opprettet for et av våre klientprosjekter. Dette er et fokusert dokument. Det er ingen fremmede detaljer, ingen overdreven notater, og alt er begrenset til en side. Målgruppen er i stand til å konsumere de tiltenkte dataene - ingenting mer, intet mindre.

Å oppnå fokus i UX-dokumentasjon er rett og slett et spørsmål om å bruke hovedprinsippene for formål og nytte, som diskutert tidligere. Ovennevnte dokument illustrerer dette punktet ganske effektivt.

UI-designere og utviklere trenger kanskje ikke å høre alle begrunnelsene bak valgene du har gjort. Enten lagrer du den til en personlig diskusjon, eller bare fremhever de fem beste beslutningene.

Det er selvfølgelig unntak. Hvis dokumentet er ment for et medlem av QA-teamet, må du kanskje forklare alle resonnementene dine slik at de kan teste programvarens funksjonalitet tilstrekkelig - men selv da er det ikke alltid nødvendig.

Dokumentasjon er ikke et papirspor

Respekter din egen tid og dine medarbeidere. Ikke kast bort tiden på å lage dokumentasjon som ikke er fokusert. Husk å holde det nyttig og målrettet, og fjern fremmede detaljer. Forsikre deg om at dokumentasjonen du lager, blir brukt til å drive beslutningstaking, ellers kaster du bare bort tiden din.

For mer fremgangsmåter for designprosesser, last ned den gratis eBok UX-prosesser i virkeligheten: Hvordan toppbedrifter bygger produkter. Veiledningen inkluderer trinnvise prosesser fra Slack, Autodesk, 3M og andre selskaper.

Yona Gidalevitz er teknisk forsker ved full stack mobile app-utvikling og UX- og UI-designbyrå Codal.