Analytisch denken en helder schrijven



Vergelijkbare documenten
Introductie: Taal en ICT in één trainingsboek

SMART requirements schrijven

Monitoraat op Maat Academisch Nederlands 1

Dwerggras 30, Rotterdam. 1. Schrijf tijdens het kijken dingen op die jou belangrijk lijken. Je hebt dit later nodig.

Module 3: Scratch programmeren: is het logisch of is het niet logisch?

Praktijkwerkboek AKA. Kopieën maken... 8 In deze opdracht maak je kopieën van documenten.

6 Valkuilen bij het maken van testvragen die eenvoudig zijn te ontwijken. Meer informatie? Bezoek ons op

Zelfreflectie meetinstrument Ondernemende houding studenten Z&W

Handleiding Hoe pas je een PVA toe in je project? Mediamanagement leerjaar 2 Darren Arendse STAPPENPLAN VAN ONDERZOEK TOT UITVOERING

Schrijven voor het web. Roel Meertens

Faculteit der Geesteswetenschappen Instituut voor Nederlands Taalonderwijs en Taaladvies (INTT) TAALTRAININGEN VOOR STUDENTEN FGw

Hoofdstuk 3: Keuzestructuren

Medewerker interne dienst. Persoonlijke effectiviteit: 2. Accuratesse

Waarom ga je schrijven? Om de directeur te overtuigen

Praktijkwerkboek AKA. Dataverwerking. Mutaties doorvoeren... 8 In deze opdracht voer je mutaties door in een databestand.

Plan van aanpak Toogle

2.4 Tekstopbouw In deze paragraaf oefen je in het schrijven van een tekst met een indeling in inleiding, kern en slot.

Let op! Je hoeft de app niet te bouwen. Je krijgt ook geen extra punten hiervoor.

Handleiding bepaal de Lifetimevalue van je kanalen in Google Analytics

Wat ga je in deze opdracht leren? Meer leren over: soorten vragen, vraagwoorden, signaalwoorden en sleutelwoorden

GSM500 PROGRAMMATIE HANDLEIDING

Kwaliteitsbewaking en testen in ICT beheerorganisaties

Waarom ga je schrijven? Om de directeur te overtuigen

6. Project management

opdrachten algoritmiek - antwoorden

Praktijkwerkboek AKA. Kennismaken met het archief... 4 Je gaat kennismaken met een archief met papieren archiefstukken op het werk.

Elke groep van 3 leerlingen heeft een 9 setje speelkaarten nodig: 2 t/m 10, bijvoorbeeld alle schoppen, of alle harten kaarten.

Training Projectmanagement

HOE GEEF IK DE WEEK VORM? Handvatten voor de invulling van een werkplek tijdens de Week van de Mobiliteit

Blue-Bot ONDERWIJSGIDS

Hoe ondernemend is jouw OR?

J L. Nordwin College Competentiemeter MBO - 21st Century & Green Skills. Vaardigheden Gedragsindicatoren. 21st Century Skill - -

HOOFDSTUK 3. Imperatief programmeren. 3.1 Stapsgewijs programmeren. 3.2 If Then Else. Module 4 Programmeren

De workshop Zakelijk schrijven wordt incompany gegeven en op maat aangeboden.

10 tips voor begrijpelijke AWBZ-formulieren

T-Mobile introduceert MyFaves.

Software Test Document

Software Test Plan. Yannick Verschueren

Werkschrift : Hoe werk ik op WikiKids?

Deze handleiding zal je in een aantal stappen uitleggen hoe je PlanManager kunt gaan gebruiken. De volgende handelingen worden kort behandeld:

3.3 Schrijfdoel en publiek bepalen In deze paragraaf oefen je met de schrijfstrategieën schrijfdoel en publiek bepalen.

Praktijkinstructie Geautomatiseerde informatievoorziening - beheer 3 (CIN02.3/CREBO:50170)

Workshop inschrijven op aanbestedingen

Het schrijven van stukken. Een introductie

Ontwerp rapport Digitaal Instellingsplan Hogeschool van Amsterdam

Compad Bakkerij. Document beheer. Inleiding. Debiteuren. Facturering. Compad Bakkerij Facturering

Connect Social Business

Anna en Noah starten met een opleiding in een avondschool. Ze doen een graduaat marketing. Tijdens de eerste pauze praten ze met elkaar.

Praktijkinstructie Dataverwerking 1 (CSE02.1/CREBO:50236)

Realisatiefase fase 5

Digitale zelfbeschikking biedt uw burgers controle, overzicht en inzicht

Bijlage D Nadere uitwerking van de onderwijseenheden van het Associate degree-programma:

Individueel procesverslag

EEN E MAIL STUREN NAAR EEN DOCENT

Schrijven van studiemateriaal

Medewerker contractmanagement. Denkkracht: 3. Analytisch vermogen

1) Opmaak van een sterk CV

Logistiek medewerker. Persoonlijke effectiviteit: 2. Accuratesse

Taaltrainingen voor studenten FGw. Workshops en cursussen voor studenten van de Faculteit der Geesteswetenschappen

Welkom Hoe start ik als Netwerk Member?

Case. Study. Orbis Software

Richtlijnen schrijven (stage-of afstudeer)verslag

Handleiding Sollicitatiebrief

De kunst van wetenschappelijk schrijven

Schrijven van studiemateriaal

Les 1: Een verzorgingskaart maken voor je huisdier

Handleiding voor studenten

Releasenotes:

Quickstart handleiding

Wat maakt WizeNote uniek?

Paragraaf 9.7 Opdracht 15

Basistechnieken Microsoft Excel in 15 minuten

Reflectie Verslag. 25 januari. Game Developement Informatica Hogeschool v. Amsterdam

OPDRACHTKAART. Thema: Multimedia. Het multimedia productieproces 3. De uitvoering MM

Onderzoeksvaardigheden (Creatieve Actie Methodologie)

Begrijpelijke Taal. doelgericht schrijven Workshop 25 november 2013

Rapport Team Competenties i360. Test Kandidaat

5 praktische tips voor waardevolle evaluaties

Inhoud. Installatie Algemeen Gebruik Techniek App beëindigen/blokkeren

Communiceren met de achterban

Tentamen Systeemontwikkeling 1 (I00100)

Bepaal eerst de probleemstelling of hoofdvraag

Plan van Aanpak. Opdrachtnemers: Hielke Kuipers Opdrachtgever: Mr. Gerard van Kruiningen

Als een PSD selecties bevat, deelt de lijn van het programma zich op met de verschillende antwoorden op het vraagstuk.

Activiteitenprogramma werk en zinvolle dagbesteding

In Vlaanderen bestaat er nog geen leerlijn programmeren! Hierdoor baseren wij ons op de leerlijn die men in Nederland toepast voor basisscholen.

Software Quality Assurance Plan

Factsheet Vragen en antwoorden Versie: oktober NL-Alert. Direct informatie bij een noodsituatie

Software Test Plan. Yannick Verschueren

project: Introductie Helpende Zorg & Welzijn

Connect Social Business. Plan van Aanpak voor mijn stage bij ConnectSB

Checklist opmaken van een nieuwsbrief Sendt

ALGEMEEN. Doel & inhoud. Evaluatie

SJABLOON ETHISCHE ANALYSE aan de hand van een stappenplan

Een sterk CV en motivatie

Producten en Services Product- en Programmalevering Checklist

Zelfreflectie Jaar 1 Marco Kleine Deters Bedrijfskundige Informatica

HOE STIMULEER JE HET GEBRUIK VAN INTRANET?

Handleiding Vodafone Voic

Disclaimer Het bestand dat voor u ligt, is nog in ontwikkeling. Op verzoek is deze versie digitaal gedeeld. Wij willen de lezer er dan ook op wijzen

Transcriptie:

Analytisch denken en helder schrijven Een trainingsboek voor ICT ers en studenten Hossein Chamani

Inhoud Voorwoord 7 Introductie: Taal en ICT in één trainingsboek 11 1 Schrijfopdrachten scherp analyseren 15 1.1 Onderzoek wie de opdrachtgever is 17 1.2 Onderzoek wie de beoogde lezers zijn 17 1.3 Onderzoek wie de coauteurs zijn 18 1.4 Onderzoek de aanleiding, het belang en de doelen van de schrijfopdracht 18 1.5 Stel een opleverdatum en -tijd vast voor de tekst 19 1.6 Maak een opdrachtomschrijving en planning 19 1.7 Zorg ervoor dat iedereen de opdrachtomschrijving en planning begrijpt 19 2 Teksten logisch structureren 21 2.1 Formuleer de centrale vraag en de subvragen van de lezers 23 2.2 Ontwerp een logische structuur 24 2.3 Zet het kernpunt aan het begin van de tekst 27 2.4 Werk volgens een top-downstructuur 29 2.5 Verwijder overbodige onderdelen 34 2.6 Controleer de structuur op volledigheid 35 2.7 Maak de logische structuur zichtbaar 36 2.8 Oefeningen Teksten logisch structureren 38 3 Zinnen helder formuleren 43 3.1 Schrijf op basis van juiste redeneringen 45 3.2 Schrijf precies en volledig 46 3.3 Behandel slechts één onderwerp per zin 47 3.4 Formuleer actieve zinnen 48 3.5 Formuleer positieve zinnen 50 3.6 Plaats het kernpunt aan het begin van de zin 51 3.7 Verwijder overbodige woorden 52 3.8 Oefeningen Zinnen helder formuleren 53 5

Analytisch denken en helder schrijven 4 Duidelijke woorden gebruiken 61 4.1 Gebruik eenvoudige woorden 63 4.2 Gebruik woorden eenduidig 65 4.3 Gebruik kwantitatieve woorden 66 4.4 Gebruik actieve woordcombinaties 67 4.5 Leg onbekende termen en afkortingen uit 68 4.6 Wees consequent in terminologiegebruik 70 4.7 Begrijp elk woord dat je gebruikt 72 4.8 Oefeningen Duidelijke woorden gebruiken 73 5 Je taal- en ICT-brein verder trainen 75 5.1 Een algoritme of broncode vertalen naar requirements 76 5.2 Acceptatiecriteria schrijven 79 5.3 Kennis vergaren en kennis delen 81 6 Uitwerkingen 83 Hoofdstuk 1 Schrijfopdrachten scherp analyseren 83 Hoofdstuk 2 Teksten logisch structureren 83 Hoofdstuk 3 Zinnen helder formuleren 88 Hoofdstuk 4 Duidelijke woorden gebruiken 94 Aanbevelingen 95 6

Introductie: Taal en ICT in één trainingsboek Als je het niet eenvoudig kunt uitleggen, begrijp je het zelf niet. Albert Einstein (1879-1955) Veel hbo-studenten en ICT ers hebben moeite met helder schrijven, terwijl dat een belangrijke succesfactor is voor hun professionele loopbaan. Helder schrijven vereist analytisch en helder denken. Met dit boek train je je taal- én ICT-brein door ICT-problemen te analyseren en helder te beschrijven. Leerdoelen Na het bestuderen van dit boek kun je: 1. schrijfopdrachten scherp analyseren 2. teksten logisch structureren 3. zinnen helder formuleren 4. duidelijke woorden gebruiken 5. je taal- en ICT-brein verder trainen. De belangrijkste onderdelen van dit trainingsboek zijn praktische voorbeelden en oefeningen met uitwerkingen. Alle voorbeelden en oefeningen komen uit de beroepspraktijk van ICT ers. Trainingsgericht taalgebruik Wanneer je dit boek gaat gebruiken, sta je waarschijnlijk onder tijdsdruk. Daarom is het bondig en puntsgewijs geschreven. De zinnen zijn kort en actief geformuleerd. Woordvariaties zijn alleen toegepast als het niet anders kon. Je komt geen taalkundige vaktermen tegen die de kennisoverdracht vertragen. De verworven kennis is direct toepasbaar. 11

Analytisch denken en helder schrijven Hoe gebruik je dit trainingsboek? Dit boek is geschikt voor zowel zelfstudie als cursussen bij hogescholen, trainingsinstituten, bedrijven en instellingen. De hoofdstukken en de paragrafen van dit boek kun je in elke gewenste volgorde bestuderen. Je kunt deze volgorde bepalen op basis van de prioriteiten van je leerdoelen. Wil je beginnen met een schrijfopdracht? In dit boek krijg je 28 handreikingen voor helder schrijven. De handreiking zijn ingedeeld in vier hoofdstukken zoals weergegeven in figuur 1. Figuur 1 De indeling van de handreikingen De checklist op pagina 14 geeft een overzicht van de handreikingen. Deze handreikingen zijn toepasbaar voor het schrijven van teksten in het Nederlands en in het Engels. 12

Introductie Taal en ICT in één trainingsboek Hoe gebruik je de checklist? Stel bij elke schrijfopdracht eerst vast welke handreikingen van de checklist géén toegevoegde waarde hebben voor jouw specifieke schrijfdoelen. Markeer deze handreikingen als onbruikbaar. Toets vervolgens iedere overgebleven handreiking op doelmatigheid. Pas deze handreikingen aan als het nodig is. Controleer daarna de checklist op volledigheid. Formuleer nieuwe handreikingen als het nodig is. Geef elke bruikbare handreiking van de checklist een prioriteitslabel (Vereist, Belangrijk, Handig). 13

Analytisch denken en helder schrijven Checklist voor schrijfopdrachten Hoofdstuk 1: Schrijfopdrachten scherp analyseren Vereist Belangrijk Handig Onbruikbaar 1.1 Onderzoek wie de opdrachtgever is 1.2 Onderzoek wie de beoogde lezers zijn 1.3 Onderzoek wie de coauteurs zijn 1.4 Onderzoek de aanleiding, het belang en de doelen van de schrijfopdracht 1.5 Stel een opleverdatum en -tijd vast voor de tekst 1.6 Maak een opdrachtomschrijving en planning 1.7 Zorg ervoor dat iedereen de opdrachtomschrijving en planning begrijpt Hoofdstuk 2: Teksten logisch structureren Vereist Belangrijk Handig Onbruikbaar 2.1 Formuleer de centrale vraag en de subvragen van de lezers 2.2 Ontwerp een logische structuur 2.3 Zet het kernpunt aan het begin van de tekst 2.4 Werk volgens een top-downstructuur 2.5 Verwijder overbodige onderdelen 2.6 Controleer de structuur op volledigheid 2.7 Maak de logische structuur zichtbaar Hoofdstuk 3: Zinnen helder formuleren Vereist Belangrijk Handig Onbruikbaar 3.1 Schrijf op basis van juiste redeneringen 3.2 Schrijf precies en volledig 3.3 Behandel slechts één onderwerp per zin 3.4 Formuleer actieve zinnen 3.5 Formuleer positieve zinnen 3.6 Plaats het kernpunt aan het begin van de zin 3.7 Verwijder overbodige woorden Hoofdstuk 4: Duidelijke woorden gebruiken Vereist Belangrijk Handig Onbruikbaar 4.1 Gebruik eenvoudige woorden 4.2 Gebruik woorden eenduidig 4.3 Gebruik kwantitatieve woorden 4.4 Gebruik actieve woordcombinaties 4.5 Leg onbekende vaktermen en afkortingen uit 4.6 Wees consequent in terminologiegebruik 4.7 Begrijp elk woord dat je gebruikt 14

3 Zinnen helder formuleren In dit hoofdstuk krijg je zeven handreikingen voor het formuleren van zinnen. De onderstaande lijst geeft een overzicht van de handreikingen met de paragraafnummers die erbij horen: 3.1 Schrijf op basis van juiste redeneringen 3.2 Schrijf precies en volledig 3.3 Behandel slechts één onderwerp per zin 3.4 Formuleer actieve zinnen 3.5 Formuleer positieve zinnen 3.6 Plaats het kernpunt aan het begin van de zin 3.7 Verwijder overbodige woorden Wees kritisch en creatief! Toets de handreikingen hierboven op volledigheid en bruikbaarheid wanneer je ze in praktijk toepast. Pas ze aan of creëer nieuwe handreikingen als het nodig is. 43

Analytisch denken en helder schrijven Startoefening In het tekstfragment hieronder is een probleemstelling beschreven. De tekst is overgenomen van de eerste versie van de opdrachtomschrijving van een afstudeerproject. Opdracht 1. Bestudeer de probleemstelling. 2. Beschrijf jouw bevindingen over de begrijpelijkheid van deze probleemstelling. 3. Geef de schrijver minimaal drie adviezen om de tekst begrijpelijker te formuleren. Probleemstelling Omdat CMS- en portal-systemen draaien op applicatieplatformen die ook gebruikt worden voor maatwerksystemen, bieden deze de mogelijkheid om een maatwerkcomponent ermee te integreren. Interessant is echter om de mogelijkheden te onderzoeken om een compleet maatwerksysteem met deze standaardpakketten te integreren, te kijken welke functionaliteit van deze pakketten in het maatwerksysteem te gebruiken is en in hoeverre deze een waardevolle aanvulling vormt of zelfs delen van de functionaliteit voor zijn rekening kan nemen. 44

Hoofdstuk 3 Zinnen helder formuleren 3.1 Schrijf op basis van juiste redeneringen Teksten die op basis van juiste redeneringen zijn geschreven, bevatten geen logische fouten. Logische fouten zijn denk- of redeneerfouten. Onopgemerkte logische fouten in de specificaties van een product kunnen voor fouten in het ontwerp zorgen en zo leiden tot fouten in het eindproduct. Voorbeeld Het factureringssysteem van een telecombedrijf moet 10 eurocent per sms berekenen als een abonnee minder dan 100 sms jes per maand stuurt. Wanneer de abonnee meer dan 100 sms jes stuurt, is de prijs 5 eurocent per sms. Minder dan 100 betekent maximaal 99. Meer dan 100 betekent minimaal 101. Wat doet het factureringssysteem als een klant precies 100 sms jes stuurt? Het is onduidelijk hoe het factureringssysteem de prijs berekent als het aantal verzonden sms jes groter is dan 100. Beter alternatief Het factureringssysteem genereert voor elk abonnement één keer per maand een factuur. De prijzen van de sms jes zijn in twee klassen verdeeld. De eerste 100 sms jes op de factuur kosten 10 eurocent per stuk. Alle sms jes boven de grens van 100 kosten 5 eurocent per stuk. Zie tabel 3.1. Aantal sms jes Prijs per sms Rekenvoorbeelden 1-100 10 eurocent Klant stuurt 1 sms: Sms-kosten = 1 0,10 = 0,10 Klant stuurt 100 sms jes: Sms-kosten = 100 0,10 = 10,00 101 of meer 5 eurocent Klant stuurt 101 sms jes: Sms-kosten = (100 0,10) + (1 0,05) = 10,05 Tabel 3.1 Sms-prijzen 45

Analytisch denken en helder schrijven 3.2 Schrijf precies en volledig Schrijf precies en volledig om onduidelijkheden en verkeerde interpretaties te voorkomen. Voorbeeld 1 De sms-generator moet voldoende berichten kunnen simuleren om een stresstest te kunnen uitvoeren op een sms-gateway. Hoeveel sms jes zijn voldoende voor een stresstest? Beter alternatief De sms-generator moet voldoende berichten kunnen simuleren om een stresstest te kunnen uitvoeren op een smsgateway. Hiervoor moet de sms-generator minimaal 10.000 en maximaal 20.000 berichten per seconde kunnen simuleren. Voorbeeld 2 Het systeem moet de cijfers van verschillende klassen vergelijken en bepalen welke studenten hun propedeusediploma nog niet hebben behaald. Klassen hebben geen cijfers. Studenten hebben cijfers. Wat wil de schrijver zeggen met het werkwoord vergelijken? Beter alternatief Het cijfersysteem moet een namenlijst opstellen van de studenten van dezelfde studierichting en hetzelfde studiejaar die hun propedeusediploma nog niet hebben behaald. 46

Hoofdstuk 3 Zinnen helder formuleren 3.3 Behandel slechts één onderwerp per zin Voor schrijvers is het efficiënt om meerdere onderwerpen in één zin te behandelen. Maar daardoor creëren zij een probleem voor lezers die nog niet voldoende materiekennis hebben. De lezers moeten tijdens het lezen de zinnen ontleden om de tekst te kunnen begrijpen. Voorbeeld De impact en de oorzaak van een storing moeten binnen drie minuten door de storingsanalisten worden vastgesteld zodra een storingsalarm door het Network Management System wordt geactiveerd en de klantenservice evenals netwerkspecialisten moeten binnen vijf minuten hierover worden geïnformeerd zodat het probleem wordt opgepakt. Beter alternatief Zodra een storing in het netwerk optreedt, activeert het Network Management System een alarm. De storingsanalisten stellen binnen drie minuten de impact en de oorzaak van de storing vast. Binnen vijf minuten informeren de analisten de klantenservice over de storing en de impact en oorzaak ervan. Tegelijkertijd schakelen de analisten netwerkspecialisten in om de storing op te lossen. Verminder het aantal woorden per zin Door slechts één onderwerp per zin te behandelen, verminder je ook het aantal woorden per zin. Je vergroot hiermee het leesgemak. 47

Analytisch denken en helder schrijven 3.4 Formuleer actieve zinnen In een actieve zin is het duidelijk wie of wat de actor is en welke handelingen deze actor verricht. In dit boek definiëren wij een actor als een persoon, instantie of een technisch element dat een handeling kan verrichten. Actieve zinnen kun je makkelijker vertalen naar ontwerpen, algoritmes of broncodes omdat bij actieve zinnen de actoren en de handelingen bekend zijn. Voorbeeld 1 Passief: De laser wordt uitgeschakeld zodra de connector van de glasvezelkabel wordt losgekoppeld van de Add & Drop Multiplexer. Beter alternatief Actief: De Control Unit schakelt de laser uit zodra iemand de connector van de glasvezelkabel van de Add & Drop Multiplexer loskoppelt. Voorbeeld 2 Passief: De opdrachtgever wordt geïnformeerd wanneer de vastgestelde deadlines van het project niet kunnen worden gehaald. Beter alternatief Actief: De projectleider informeert de opdrachtgever wanneer de projectgroep de vastgestelde deadlines van het project niet kan halen. 48

Hoofdstuk 3 Zinnen helder formuleren Uitzonderingen Passieve zinnen gebruik je als de actor niet bekend of niet belangrijk is. In sommige situaties kan het gebruik van actieve zinnen vreemd overkomen. Zie voorbeeld 3. Voorbeeld 3 Actief: Mijn collega veroorzaakte de storing door een verkeerde parameter in te voeren. Beter alternatief Passief: De storing werd veroorzaakt door een menselijke fout in onze organisatie. 49

Hoofdstuk 3 Zinnen helder formuleren 3.8 Oefeningen Zinnen helder formuleren Oefening 1 Figuur 3.1 toont een flowchart. Deze flowchart is ontworpen op basis van de kortingsregels die een academische boekhandel in het eigen kassasysteem wil laten programmeren. Figuur 3.1 Kortingsregels Opdracht Formuleer de tekst waarop het ontwerp van deze flowchart gebaseerd is. 53

Analytisch denken en helder schrijven Oefening 2 Een applicatie berekent het aantal jaarlijkse vakantiedagen van de medewerkers van een bedrijf op basis van het volgende algoritme: Read Dienstjaren If Dienstjaren > 20 Then Vakantiedagen = 35 Else If Dienstjaren > 10 Then Vakantiedagen = 30 Else If Dienstjaren > 5 Then Vakantiedagen = 25 Else Vakantiedagen = 20 Endif Endif Endif Print Vakantiedagen Opdracht Formuleer de tekst waarop het ontwerp van het algoritme gebaseerd is. 54

Hoofdstuk 3 Zinnen helder formuleren Oefening 3 Figuur 3.2 toont een flowchart. Met deze flowchart kun je vaststellen of een jaar een schrikkeljaar of een gewoon jaar is. Figuur 3.2 Vaststellen van schrikkeljaren In de flowchart zie je de operator MOD (modulo division). MOD berekent de rest van een deling. Voorbeelden V 2000 MOD 400 = 0. Als je het jaartal 2000 deelt door 400 dan is de rest 0. 2000 is een veelvoud van 400 omdat de rest gelijk aan 0 is. Het jaar 2000 was dus een schrikkeljaar. V 2009 MOD 400 = 9. Als je het jaartal 2009 deelt door 400 dan is de rest 9. 2009 is geen veelvoud van 400 omdat de rest niet gelijk aan 0 is. Het jaar 2009 was dus een gewoon jaar. Opdracht a. Beschrijf hoe je kunt vaststellen of een jaar een schrikkeljaar of een gewoon jaar is. b. Zet de uitwerking van opdracht a om in een algoritme. 55

Analytisch denken en helder schrijven Oefening 4 Een opdrachtgever heeft onderstaande testconditie aan een testanalist gegeven: Een wachtwoord moet minimaal zes letters en twee cijfers bevatten. De testanalist moet op basis van deze testconditie concrete testcases schrijven. De testcases worden vervolgens door testers en gebruikers gebruikt om een applicatie te testen. Hieronder zie je twee testcases als voorbeeld: ID Input Verwacht resultaat 1 Loginnaam: gast44 De gebruiker krijgt toegang tot de applicatie. Wachtwoord: logisch01 2 Loginnaam: gast44 Wachtwoord: logisch Foutmelding 1: U heeft een verkeerde loginnaam en/of verkeerd wachtwoord ingevoerd. Probeer het opnieuw. Tabel 3.2 Voorbeeld van twee testcases; ID = Testcase identifier Opdracht a. Welke vragen kan de testanalist aan de opdrachtgever stellen? Voorbeeld van een vraag: Wat mag de maximale lengte van een wachtwoord zijn? De testconditie suggereert dat een wachtwoord oneindig groot mag zijn. b. Verbeter de testconditie en/of maak deze compleet. Voorbeeld van een extra testconditie: Een wachtwoord mag bestaan uit maximaal vijftien karakters. 56

Hoofdstuk 3 Zinnen helder formuleren Oefening 5 De tekst hieronder bevat minimaal één logische fout (redeneerfout): Een multimediabedrijf wil een nieuwe dienst aanbieden waarmee de abonnees via een website gratis sms jes kunnen versturen naar mobiele nummers. Een abonnee mag maximaal tien sms jes per dag sturen. Een sms mag maximaal 120 karakters bevatten. Het multimediabedrijf verwacht dat de abonnees per dag gemiddeld een miljoen sms jes zullen versturen. De website moet dus twaalf sms jes per seconde kunnen verwerken. Opdracht a. Vind de logische fout in de bovenstaande tekst. b. Onderbouw je bevindingen met argumenten. 57

Analytisch denken en helder schrijven Hoofdstuk 3 Zinnen helder formuleren Startoefening Je kunt de schrijver adviseren een aantal van de zeven handreikingen van hoofdstuk 3 toe te passen om zijn tekst begrijpelijker te formuleren. Oefening 1 Alternatief 1: Klanten met een studentenkaart krijgen 10% korting. Klanten die een kortingskaart hebben, krijgen 12% korting. Klanten met een kortingskaart en een studentenkaart krijgen 20% korting. Alle andere klanten betalen het volledige tarief. Alternatief 2: Als een klant een studentenkaart heeft, dan krijgt hij/zij 10% korting. Als een klant een kortingskaart heeft, dan krijgt hij/zij 12% korting. Als een klant een kortingskaart en een studentenkaart heeft, dan krijgt hij/zij 20% korting. Anders krijgt de klant geen korting. 88

Hoofdstuk 6 Uitwerkingen Oefening 2 Alternatief 1 Een bedrijf berekent het aantal vakantiedagen van de medewerkers op basis van het aantal dienstjaren bij het bedrijf. Het aantal dienstjaren en het aantal corresponderende vakantiedagen per jaar zijn in vier klassen verdeeld. Tabel 6.1 geeft een totaal overzicht: Klasse 1 Klasse 2 Klasse 3 Klasse 4 Aantal dienstjaren 1-5 6-10 11-20 21 of meer Aantal vakantiedagen per jaar 20 25 30 35 Tabel 6.1 Aantal dienstjaren en vakantiedagen per jaar Alternatief 2 Een bedrijf berekent het aantal vakantiedagen van de medewerkers op basis van het aantal dienstjaren bij het bedrijf. Het aantal dienstjaren en het aantal corresponderende vakantiedagen per jaar zijn in vier klassen verdeeld. Hieronder zie je een overzicht: Klasse 1: vanaf jaar 1 tot en met 5 krijgt de medewerker 20 vakantiedagen. Klasse 2: vanaf jaar 6 tot en met 10 krijgt de medewerker 25 vakantiedagen. Klasse 3: vanaf jaar 11 tot en met 20 krijgt de medewerker 30 vakantiedagen. Klasse 4: vanaf jaar 21 krijgt de medewerker 35 vakantiedagen. 89

Analytisch denken en helder schrijven Oefening 3 Een jaar is een schrikkeljaar als het jaartal een veelvoud is van 400 of als het jaartal een veelvoud is van 4 maar niet een veelvoud 100. In alle andere gevallen is het jaar een gewoon jaar. a. If (Jaar MOD 400 = 0) OR (Jaar MOD 4 = 0 AND Jaar MOD 100 <> 0) then Jaar = SCHRIKKELJAAR else Jaar = GEWOONJAAR. (<> betekent niet gelijk aan). Voorbeelden Het jaar 2000 was een schrikkeljaar, omdat 2000 een veelvoud is van 400. 2000 MOD 400 = 0. Het jaar 2008 was een schrikkeljaar, omdat 2008 een veelvoud is van 4 maar niet een veelvoud van 100. 2008 MOD 4 = 0 en 2008 MOD 100 <> 0. Het jaar 1900 was een gewoon jaar, omdat 1900 geen veelvoud is van 400 maar wel een veelvoud van 100. 1900 MOD 400 <> 0 en 1900 MOD 100 = 0. Het jaar 2009 was een gewoon jaar, omdat 2009 geen veelvoud is van 4. 2009 MOD 4 <> 0. 90

Hoofdstuk 6 Uitwerkingen Oefening 4 Deel a Hieronder zie je drie vragen die de testanalist aan de opdrachtgever kan stellen. Er zijn meer goede vragen mogelijk dan hier vermeld. 1. De testconditie kan op twee manieren worden geïnterpreteerd. Welke van de onderstaande interpretaties is juist? Een wachtwoord moet minimaal zes letters en altijd twee cijfers bevatten. Een wachtwoord moet minimaal zes letters en minimaal twee cijfers bevatten. 2. Mag een wachtwoord symbolen bevatten? De testconditie suggereert dat zolang het wachtwoord minimaal zes letters en twee cijfers bevat, het ook symbolen mag bevatten zoals @, #, $, %, &, < en >. 3. Maakt het wachtwoord onderscheid tussen hoofdletters en kleine letters? De testconditie maakt niet duidelijk of het wachtwoord onderscheid maakt tussen hoofdletters en kleine letters (case-sensitive). Deel b Testers en programmeurs vinden de combinatie van de onderstaande zinnen een beter alternatief. Een wachtwoord mag bestaan uit maximaal vijftien karakters. Letters en cijfers zijn de enige karakters die zijn toegestaan. Het wachtwoord moet minimaal zes letters en minimaal twee cijfers bevatten. Het wachtwoord maakt onderscheid tussen hoofdletters en kleine letters. Een voorbeeld van een acceptabel wachtwoord: asq4kip6. 91

Analytisch denken en helder schrijven Oefening 5 De tekst suggereert dat de schrijver het gemiddeld aantal sms jes per dag (1 miljoen) als uitgangspunt neemt om vast te stellen hoeveel sms jes de website per seconde moet kunnen verwerken. Twaalf sms jes per seconde wordt als uitkomst genoemd. Twaalf sms jes per seconde is niet logisch. Sms-verkeer kent pieken en dalen. De abonnees verwachten dat een sms altijd binnen enkele seconden de eindbestemming bereikt. Daarom is het logisch dat je de piekbelasting per seconde als uitgangspunt neemt om de vereiste prestatie van de website vast te stellen. Anders wordt de website onacceptabel traag. Oefening 6 Medewerkers die bij de technische dienst werken krijgen altijd een dienstauto. Een medewerker krijgt een reiskostenvergoeding als de afstand woon-werkverkeer groter is dan drie kilometer. In andere gevallen krijgt een medewerker een gratis fiets. Oefening 7 Tabel 6.2 geeft een OR Function weer. Oorzaak (conditie) Case 1 Case 2 Case 3 Case 4 Staat Dipswitch 1 op positie ON? Nee Nee Ja Ja Staat Dipswitch 2 op positie ON? Nee Ja Nee Ja Gevolg (actie) Service Module A is Active X X X Service Module A is Stand-by X Tabel 6.2 OR Function 92

Analytisch denken en helder schrijven Veel hbo-studenten en ICT ers hebben moeite met helder schrijven terwijl dit een belangrijke succesfactor is voor hun professionele loopbaan. Daarom is dit trainingsboek geschreven voor hbo-studenten en ICT ers. Helder schrijven vereist analytisch en helder denken. Met dit boek train je je taal- én ICT-brein door ICT-problemen te analyseren en helder te beschrijven. Leerdoelen Na het bestuderen van dit boek kun je: met uitwerkingen. Alle voorbeelden en oefeningen komen uit de beroepspraktijk van ICT ers. Trainingsgericht taalgebruik kennisoverdracht vertragen. De verworven kennis is direct toepasbaar in de praktijk. Hoe gebruik je dit trainingsboek? bedrijven en instellingen. De hoofdstukken en de paragrafen van dit boek kun je in elke gewenste Hossein Chamani heeft ruim vijftien jaar ervaring in rollen als Network Manager, Network Integrator, Test Manager, Project Manager, trainer en docent. Sinds 2001 is hij docent telecommunicatie, software testen en technisch schrijven aan Hogeschool Rotterdam. Hij geeft gastlessen bij hogescholen in België, Finland en Frankrijk. www.sdu.nl ISBN NUR 978 90 395 2628 6 123 / 980 www.academicservice.nl