Hoppa till innehållet

Skrev om felmeddelanden som skyllde på användare

Skrev om applikationens felmeddelanden enligt en skriftlig tonstandard efter att en nekad inloggning hade skyllt på användaren för felskrivning när leverantören i själva verket krävde ett appspecifikt lösenord, och täckte det med ett test som namnger leverantören.

felmeddelanden som pekar ut orsaken, inte användaren

Situation. En inloggning mot en stor e‑postleverantör misslyckades, och applikationen sa till användaren att lösenordet var fel. Det var inte fel. Den leverantören kräver ett applikationsspecifikt lösenord för klienter från tredje part och avvisar kontots lösenord hur noggrant det än skrivs. Meddelandet skickade användaren till att skriva om något som aldrig kunde fungera, och den faktiska instruktionen — gå och skapa en annan sorts lösenord — fanns ingenstans.

Uppgift. Felmeddelandena måste skrivas om mot en nedskriven standard i stället för att lappas ett i taget, eftersom det här var det synliga exemplet på en vana som löpte genom dem alla.

Handling. Standarden har tre krav: säg vad som hände, antyd aldrig att användaren gjorde något fel när orsaken ligger någon annanstans, och ange nästa steg när det finns ett. När standarden tillämpades på alla felmeddelanden visade det sig att de flesta bröt mot minst ett krav — flera var det underliggande bibliotekets felsträng som skickades vidare, vilket beskriver ett tillstånd för en programmerare snarare än en situation för en människa. Leverantörsfallet skrevs om så att det namnger leverantören, anger att den kräver ett appspecifikt lösenord för andra klienter och säger var man skapar ett. Testet är det som hindrar regression, och det är medvetet specifikt: det framkallar ett inloggningsfel mot den leverantören och kontrollerar att meddelandet innehåller leverantörens namn och den fras som beskriver vilken typ av inloggningsuppgift som krävs. Ett test som bara kontrollerade att något fel visades skulle godkänna det ursprungliga felaktiga meddelandet, så kontrollen gäller innehållet, som är den enda del som någonsin var trasig.

Resultat. Felmeddelandena följer en uttalad standard och fallet som gav upphov till den täcks av ett test som fallerar på den gamla texten. Det som återstår olöst är skalan: standarden upprätthålls genom granskning och genom ett test på ett meddelande, och de andra leverantörerna med sina egna särskilda krav har inget motsvarande test, så felklassen är dokumenterad snarare än stängd.

  • Penna, kalligrafi, reservoarpenna
    Foto: SamuelFJohanns / Pixabay
  • Brev, blommor, liljekonvalj
    Foto: beasternchen / Pixabay

Använd erfarenheten i ert projekt

Använd ”Skrev om felmeddelanden som skyllde på användare” som utgångspunkt för en liknande utmaning i er organisation. Tjänsterna bakom arbetet finns tillgängliga för ert projekt. Omsätter det verksamheten vill ha till något en utvecklare kan bygga, och säger rakt ut vad som inte är värt att bygga.

Se våra tjänster Hör av er

Se bakom resultatet

Läs om situationen, besluten och resultatet i exemplet. Vi kan diskutera vad som passar era förutsättningar och vad som kräver ett annat angreppssätt. Skrev om felmeddelanden som skyllde på användare — felmeddelanden som pekar ut orsaken, inte användaren

Se våra tjänster Hör av er

En del av en längre historik — och den finns i sin helhet här.

Varje post är skriven på samma sätt: situationen, uppgiften, vad vi gjorde och vad som förändrades.

Se hela historiken

Definiera förbättringen ni behöver

Ta med beslutet, människorna som berörs och alternativen som övervägts. Vi kan tydliggöra avvägningarna och lämna en dokumenterad rekommendation.

Se vad det kostar Hör av er

Skyller dina felmeddelanden på användaren?

Fråga om besluten bakom ”Skrev om felmeddelanden som skyllde på användare”. Ni talar med personer som kan förklara arbetet och bedöma ert eget projekt.

Se våra tjänster
welcome@engineer.company +45 50 10 61 84 Köpenhamn, Danmark
QR-kod för Skrev om applikationens felmeddelanden enligt en skriftlig tonstandard efter att en nekad inloggning hade skyllt på användaren för felskrivning när leverantören i själva verket krävde ett appspecifikt lösenord, och täckte det med ett test som namnger leverantören.
Ta med dig den här sidanhttps://advisory.engineer.company/sv/portfolio/rewrote-error-messages-to-stop-blaming-users/