A hatékony hibabejelentések

Te fel a kannát a tűzhely, a háttérvilágítás bekapcsolásához rajta, hogy milyen finom a közeli serpenyőben tette meg férj és valami könnyű és ott. Ahogy mondani vele erről?







„Kedves, változtatni egy villanykörte a konyhában”, vagy „Drágám, itt van ez a dolog nem ragyog”? Ezen a ponton a kedvenc delves a legújabb verzióját a felforgatás, hogy kitaláljam, hogyan lehet egyesíteni a két tárolók, és a fény neki -, hogy az izzót.

Hogyan mondd el neki a világítást? Pontosabban, úgyhogy kérdezzük meg magunktól: mit mondott a világítást, hogy hallotta, észrevette, és világosan megérteni, mi a probléma?

Ez az úgynevezett „hibajelentés» (hibajelentés), jelentse a hibát. Ez a koncepció származik a szoftverfejlesztés terén, de ez vonatkozik az emberi kommunikáció általában. Nem mintha ez nagyon fontos része életünknek, de jó tudni, hogyan kell figyelni, hogy az emberek és kollégái a problémát. Sőt, mert nem célja, hogy egyszerűen felhívni a figyelmet arra a problémára, az a tény, a létezéséről. Fontos, hogy a beszélő megértette, hogy pontosan mi a lényege, és hogy a háttérben agya azonnal megpördült keresési megoldásokat.

Fuzzy hibajelentés ( „ahol ez a dolog nem süt”) akkor is le kell csökkenteni (finomítani), elhatárolható. De ez időt vesz igénybe, és további felvilágosítást ( „micsoda dolog? És miért gondolja, hogy meg kell ragyog?”), Hogy nem fog működni anélkül, hogy az idegeket. És az idegek védeni kell.

A programozók hozzászokott megfogalmazni gondolataikat világosan (jó, oké, ez egy bók), jött egy egyszerű képlet, amellyel meg lehet kommunikálni egymással a problémák hosszú éveken ágazat fejlődését.

Formula tökéletes hibabejelentések

Formula tökéletes hibabejelentések három egyszerű pontot:

Mit kell tenni?
(Szükséges lépéseket a hiba reprodukálásához)

Mi történik?
(A tényleges eredmények)

Ez várható, hogy?
(Várt eredmények)

Ezen kívül el kell mondanom, hogy hol a probléma jelentkezett, hogy milyen feltételek mellett, és hogy a neve a hiba.

„Drágám, bekapcsoltam a fény mint a kályha, hogy mit készítettek finom, és nem éget. Nem lehetett látni, mi volt? "

Mi tette. Konkrét lépésről lépésre meg kell tennie annak érdekében, hogy reprodukálni a hibát.

Meg is kapott. Ez kapunk következtében ezt az utasítást. Valójában, a hiba.

Mire számíthat. Mit kellett volna szerint a riportert, ami a végrehajtási utasítást.

Feltételeket. Valami, ami nem akció, de ami fontos. Például egy webes alkalmazás kell említeni a böngésző / operációs rendszer.

Név. Ez egy nagyon rövid leírást a probléma, vagy annak egy részét, ami csak lehet kiszerelni. Használt szóbeli kommunikáció, a hiba jelentések és listák, stb

Ez - egy nagyon hasznos formája:
  1. Ez átlátszó. Ez nem teszi lehetővé a riporter, hogy a kóbor elbeszélő stílusban sugárzott vagy tudatfolyam;
  2. Mert nehéz írni valami más, mint hibajelentést. Ennek eredményeként csökken a zaj mértékét a munka információk;
  3. Ez könnyen ellenőrizhető. Ie kövesse az alábbi lépéseket, akkor ugyanahhoz az eredményhez, és megerősíti, hogy a hiba létezik; megszerzéséhez, vagy más eredményre, és hozzon létre egy új hibajelentést; vagy elérni a várt eredményeket, és elutasítja a hibajelentés;
  4. Ez a hiba a jelentés világosan mutatja, ha az érvényes, azaz hogy ez a helyzet egy hiba. Hirtelen és szükség van a fényre mint a kályha, de nem égő, mert ez nem áll rendelkezésre, és az alapjárati kapcsoló, ismeretlen okok miatt titokzatos kínai?
  5. Ez a kommunikációs forma kiküszöböli a felesleges (teljesen bosszantó közös tisztázó kérdéseket);
  6. Ez a forma könnyen a vonat kábult felhasználók számára; Csak két vagy három napig, hiszti és kollégái megtanulnak kommunikálni egyértelműen;
  7. Mondja, hogy hibabejelentés, hogy várható, hogy a felhasználó, akkor tehát, mint azt igazolja, hogy tulajdonosa a rendszert, és megérteni, hogyan kell működnie ebben az esetben;
  8. Ez a hiba a jelentés nem motiválja a felelős személyt, hogy dugja be a sarokra, és felejtsd el a lehető leghamarabb;






És most - diák

Egy tipikus hiba, amelyeket a felhasználó azt mondta:

Nem tudok bejelentkezni

Azt vártam, hogy megkapja:
1. „helytelen jelszó” belépés formában a diagnózis vagy
2. A főoldalon a rendszer a felhasználó számára

Feltételek:
MSIE 4.01 / Windows ME

Egy tipikus hiba volt megfigyelhető a rendszergazda:

Mi tette:
Indított /etc/init.d/exim4 restart a szerver lopata.something.com

Ezt kaptam:
érintés: `/ var / lib / exim4„: könyvtár nem található

Mire számíthat:
exim újraindítása Ubuntu szokásos üzenet a sikeres újraindítás szolgáltatás

Egy tipikus hiba észrevették a programozó:

Mi tette:
használja dbPeerAccessor;
használja DBI;

my $ DBH = DBI-> connect ( "dbi: mysql: TELME", "TELME", "TELME");
my $ dbAccess = $ dbPeerAccessor-> új ($ DBH);

Ezt kaptam:
$ DbAccess-> verzió () == undef

Mire számíthat:
$ DbAccess-> verzió () == "1.3.0";

Feltételek:
bizalom: htdocs egor $ mysql -utelme -ptelme TELME
Üdvözöljük a MySQL monitor. Parancsok végződnek; vagy \ g.
A MySQL kapcsolat azonosítója 302
Szerver verzió: 5.0.51 Forrás eloszlás

Írja segítségét; 'vagy „\ h” segítségért. Type „\ c”, hogy törölje a puffer.

By the way, ez a fajta hibabejelentések (a kód) általában lehet beszámolni vizsgálatok formájában (csökkentett teszt), ugyanúgy, mint itt, csak egy, az egész forgatókönyvet. Például:

használja dbPeerAccessor;
használja DBI;

my $ DBH = DBI-> connect ( "dbi: mysql: TELME", "TELME", "TELME");
my $ dbAccess = $ dbPeerAccessor-> új ($ DBH);
printf ( "dbPeerInstance% s \ n",
definiált $ dbAccess-> változat (). „Meghatározott”. "Nem definiált");

Egy tipikus hiba volt megfigyelhető a projektvezető:

„Elfelejtett jelszó” kellene máshogy működik

Ezt kaptam:
1. „Te küldünk egy új jelszót”
2. Ez egy levél által generált új jelszót
3. Ez a jelszó működik, a régi nem működik

Mire számíthat:
Összhangban a felhasználói történetek, a levél nem jött be az új jelszót, és egy linket az oldalra, ahol a felhasználó létrehozhat egy új jelszót

Egy tipikus hiba észrevették CFO:

Miért ilyen drága helyeken?

Megjegyzés - Választható szöveget egy hibajelentést írták pontosan ebben a formában, de fontos, hogy nem volt meg a szükséges információkat. Egy példa a programozó és a legutóbbi példa tökéletesen illusztrálja, hogyan kell írni egy jó hibajelentést a teljes információt, anélkül, hogy a „Mit láttam?”, Stb

Nincs fájdalom - nincs nyereség

Nos rögzített a beteg nem igényel érzéstelenítést.

Van egy fontos pont, hogy kell figyelembe venni a végrehajtás e formája hibajelentések itt (sőt - egy üzleti folyamat) a csapatban. Az a tény, hogy senki sem tartja magát, bolond az; éppen ellenkezőleg, talál egy hibát, a felhasználó azonnal érezni a Teremtő intelligens rendszerek. Még öntudatlanul. Ezért, mivel összefüggésben az észlelt hiba, a felhasználó lesz teljesen kényelmes, és bizalommal, kitöltve a hibajelentés formájában „nem működik, és kész.”

Ezért a bevezetése szigorú formai formájában hibabejelentés fájdalmas lesz a közösség. És ha az IT-személyzet ezt a fájdalmat tapasztalt meglehetősen gyorsan, mivel az összes - racionális emberek, bevezetése távoli IT csapat érezhető lesz nagyon. Hibajelentés átláthatóvá teszi a munkát, és az átláthatóság igényel némi erőfeszítést. És nem minden ember, elvileg az erőt, hogy észre, milyen „kontextus”, és miért a másik ember nem érti meg, mert annyira egyszerű, a program nem működik, lásd itt.

Nekem, hogy végre ezt a „üzleti folyamat” a vállalat, ahol a felhasználók kommunikálni csak a menedzser, hogy működjenek együtt az ügyfelek. Ez fogadja a felhasználók megjegyzéseit és az ezek orvoslására hibajelentést. Mint minden humanista, gondolta kecses vonalak és írjon közvetlen és tompa hibajelentést nagyon nehéz volt. Ezek voltak a könnyek, hiszti és sértéseket rám egység vezetője. Teljesen őszinte könnyeket! És bár én sajnálom őt, és nem akarnak okozni az a személy fájdalmat, de én visszautasítottam egy hibajelentést hibajelentést, amíg megtanulta, hogy ne írjon ezt az egyszerű űrlapot. Ez volt körülbelül három napig. Keresztül egy pár napig volt a teljesen automata írt szép hibabejelentés, majd további hét, rájött, az értéke ez a megközelítés, és ez lett a támogatója. A produktív munka nőtt, és az ügyfelek kezdett üzemzavarok elhárítását.

Ebben a tekintetben, tudom ajánlani a következő. E megközelítés kerüljön sor a cég erővel. Meg kell kiszabni a fej, és csak akkor, ha a vezető személyesen megérteni, hogy miért ezt az erőszakot szükséges, és mi is meg fogja kapni a nyeremény a cég.

A nevem Egor Egorov. I - tehdir és társtulajdonosa Treebune.net, projekt menedzser és programozó 20+ éves tapasztalattal, a szakember a rendszerek sorbanállási és újságíró képzést. Bővebben.




Kapcsolódó cikkek