Inspektionshandbok. Sammanfattning. Redaktör: Filip Klasson Version: 1.1 Datum: I Tal-Lab kan ingen höra dig skrika

Storlek: px

Starta visningen från sidan:

Download "Inspektionshandbok. Sammanfattning. Redaktör: Filip Klasson Version: 1.1 Datum: I Tal-Lab kan ingen höra dig skrika"

Jörgen Per Fransson
för 7 år sedan
Visningar:

1 I Tal-Lab kan ingen höra dig skrika Inspektionshandbok Redaktör: Version: 1.1 Datum: Sammanfattning Detta dokument är till för att underlätta arbetet inför och under en inspektion

2 Projektidentitet Projektgrupp Stum Linköpings tekniska högskola (IDA) Projektmedlemmar Namn Ansvarsområde Telefon E-post Ali Aghajani Projektledare Kjell Enblom Dokumentansvarig Kvalitetsansvarig Johan Millving Designansvarig Andreas Rasmussen Implementationsansvarig Gustav Veide Systemansvarig Patrik Sandström Kundansvarig Thomas Janowski Testansvarig E-postlista för hela gruppen Hemsida www-und.ida.liu.se/~pum1 Kund Kundkontakt Bertil Lyberg, Mustapha Skhiri, Handledare Sten Sunnergren, Examinator och kursansvarig Robert Kaminski, IDA

3 Dokumenthistorik Version Datum Utfärdade ändringar Utfärdade av Dokumentet skapades Ändringar efter kommentering 1.1 Ändringar efter kommentarer från examinator ii

4 iii

5 1 Inspektionshandbok Syfte Inspektionens olika faser Förberedelser Inspektionsmöte Beslut Korrigering Kontroll av korrigering Felklassificering Olika typer av fel Olika klasser av fel...2 iv

6 v

7 1 Inspektionshandbok 1.1 Syfte Inspektionshandbokens syfte är att underlätta arbetet för de projektmedlemmar som skall närvara vid en inspektion av ett dokument. 1.2 Inspektionens olika faser 1. Förberedelser 2. Inspektionsmöte 3. Beslut 4. Korrigering 5. Kontroll av korrigering 1.3 Förberedelser På ett inspektionsmöte finns det tre olika arbetsuppgifter: Moderator: Leder inspektionen (detta kan vara samma person som sekreteraren). Sekreterare: Antecknar alla fel som upptäcks i ett inspektionsprotokoll. Inspektör: Inspekterar dokumentet (skall vara minst två personer). Dessa roller måste tilldelas senast dagen innan inspektionsmötet. Innan inspektionsmötet skall dokumentet kommenteras på egen hand för att upptäcka de flesta av de stora uppenbara felen och även för att bekanta sig med dokumentet. För att denna kommentering skall kunna genomföras måste redaktören av dokumentet se till att den senaste versionen finns tillgänglig senast dagen innan inspektionen. För att kunna kommentera effektivt skall man skriva direkt på en papperskopia av dokumentet och föra kommentarer enligt kvalitetsplanen [Klasson, 2005]. För att inspektionen skall vara så effektiv som möjligt skall man helst aldrig hålla en inspektion i mer än en timmar i streck. Efter en timma skall man ta en paus på 15 minuter Inspektionsmöte Moderatorns uppgift är att leda mötet samt att ta med inspektionsprotokoll, projektpärmen samt en ren papperskopia av dokumentet. Sekreteraren antecknar alla fel i inspektionsprotokollet. Mötet skall gå till enligt följande: 1. Moderatorn bestämmer hur stora delar av dokumentet som skall inspekteras åt gången. Redaktören kan gärna skicka med en checklista liknande den som finns i Appendix I i RUT 10.5 [Venuganti, 2003] och markera de punkter som känns viktiga för inspektörerna att undersöka. 2. En inspektör åt gången redogör vilka fel som upptäckts i delen. Kapitel 1: Inspektionshandbok 1

8 3. De fel som rapporteras antecknas av sekreteraren i inspektionsprotokollet samtidigt som felen markeras i den rena papperskopian av dokumentet. Inspektionsprotokollet som finns i Appendix I i RUT 10.5 [Venuganti, 2003] skall användas. 4. Punkt 1 till 3 upprepas tills den planerade delen av dokumentet inspekterats. 5. Moderatorn skriver ett felstatistikprotokoll. 6. Inspektionsprotokollet, papperskopian med alla antecknade fel lämnas till redaktören eller lämnas i projektskåpet. Det är viktigt att lösningen på fel som hittas ej diskuteras då detta gör att inspektionsmötet tar alldeles för lång tid Beslut Efter inspektionen tar deltagarna ett beslut, dessa beslut kan tas: Godkänner dokumentet. Godkänner dokumentet efter ändringar. Delar av dokumentet måste genomgå en ominspektion efter ändringar eftersom de delarna innehöll många fel. Hela dokumentet måste ominspekteras om det visar sig att större delen av dokumentet innehåller för många fel Korrigering Redaktören av dokumentet rättar de fel som upptäckts under inspektionen eller förtydligar texten i de delar där inspektionsgruppen missuppfattat något Kontroll av korrigering Efter redaktören gjort korrigeringen är det moderatorns uppgift att kontrollera redaktörens nya dokument. Om ett beslut om ominspektion tagits skall moderatorn se till att inspektionsproceduren upprepas. Om det är beslutat att dokumentet skall godkännas efter ändringar skall moderatorn endast kontrollera att redaktören genomfört ändringarna. 1.4 Felklassificering För att få ett tydligt inspektionsprotokoll skall fel antecknas enligt följande Olika typer av fel S Språk: stavfel, grammatikfel etc St Struktur: Felaktig struktur på dokumentet så som felaktig styckesindelning etc. I Innehåll: Faktafel, otydligt formulerat etc K Konsistensfel: T ex Motsägelser L Layout: Felaktigt utseende. Ö Övrigt: Övriga fel som inte passar in under någon specifik feltyp Olika klasser av fel A Allvarligt fel: Fel som påverkar övriga dokument. S Stort fel: Fel som måste rättas till, samt fel där mycket måste ändras. 2 Kapitel 1: Inspektionshandbok

9 L Litet fel: Ett fel med litet betydelse där allt fortfarande fungerar som det skall. Exempel stavfel i kvalitetsplanen. P Påpekande: Tveksamheter, t ex att en mening måste omformuleras. Kapitel 1: Inspektionshandbok 3

10 4 Kapitel 1: Inspektionshandbok

Relevanta dokument

STUM. Övergripande Testplan. Sammanfattning. Redaktör: Thomas Janowski Version: Syntetiskt tal utan modulering

STUM. Övergripande Testplan. Sammanfattning. Redaktör: Thomas Janowski Version: Syntetiskt tal utan modulering STUM Syntetiskt tal utan modulering Övergripande Testplan Redaktör: Version: 1.1 Sammanfattning Detta är en övergripande testplan som i stora drag beskriver planerade testfaser och testaktiviteter under