Retningslinjer for udarbejdelse af snydeark
Snydeark og sammensatte snydeark gør det muligt for brugeren af nå et mål ved at afslutte en sekvens trinvist.
Disse retningslinjer beskriver, hvornår snydeark skal anvendes, og hvordan man skriver et snydeark bedst.
Hvornår skal snydeark oprettes?
Snydeark er velegnede til opgaver, som består af trin, der leder mod et håndgribeligt mål, f.eks. bygning af et enkelt program. Målet skal være veldefineret, så brugeren er kan se en afslutning, når alle trin i snydearket er afsluttet. Øveprogrammer er ofte velegnede til snydeprogrammer, da formålet med et øveporgram er at lære, hvordan man udfører en bestemt opgave. Snydeark består normalt af op til 10 trin og kan afsluttes på en halv time eller mindre.
Til større opgaver bør man bruge et sammensat snydeark.
Hvornår skal sammensatte snydeark oprettes
Sammensatte snydeark anvendes til at give retningslinjer gennem en opgave, som er for stor til at blive beskrevet i et enkelt snydeark, eller som har flere mål. Et sammensat snydeark kan anvendes til at beskrive en sekvens af opgaver, som hver især bygger på den forudgående opgave.
Hvornår skal der ikke anvendes snydeark?
Snydeark arbejder bedst, når et problem kan løses med en sekvens af enkle trin. Snydeark er ikke en erstatning for hjælpesystemet, der tager hensyn til oprettelse af HTML-sider med grafik og vilkårlig adgang til oplysninger vha. søgning og link. Snydeark er ikke beregnet til opgaver, der kræver, at store mængder tekst angives af brugeren.
Retningslinjer for oprettelse af snydeark
- Vælg en kort og meningsfyldt titel.
- Udnyt link til hjælpesystemet i snydeark, når det er muligt at stille mere detaljerede oplysninger til rådighed i baggrunden.
- Overvej, om snydearket skal omarbejdes til et sammensat snydeark, hvis der er mere end 10 trin.
- Brug kommandoer, hvor det er muligt, for at udføre kedelige opgaver som åbning af perspektiver, åbning af ressourcer og udførelsesguider. Sørg for også at give en beskrivelse af, hvordan man kan opnå den samme effekt uden at bruge kommandoen.
- Sørg for, at kommandoer kan springes over, hvis brugeren beslutter sig for at udføre trinnet manuelt.
- Angiv dialog="true" for trin, der åbner en dialogboks. Dette vil forårsage, at snydearket åbnes i en
"tray" til højre for de fleste dialogbokses vedkommende.
- Organisér trinene på en sådan måde, at brugeren ser synlige tegn på udførelsen hyppigt. Et snydeark, der foretager et antal forskellige ændringer af en Java-kilde og derefter starter et program, kan skrives om, så programmet starter efter hver kildeændring.
- Sørg for, at brugeren forstår, hvorfor de udfører hvert trin.
- I stedet for at beskrive flere måder at udføre et trin på bør du tage den enkleste måde, der kræver mindst beskrivelse.
- Brug koden for ny linje (<br/>) for at gøre teksten læseværdig.
- Underordnede elementer kan anvendes til at opdele trin i mindre trin.
- Ikke alle snydeark kræver underordnede elementer.
- Start etikettekst for underordnede elementer ved at bruge handligsord som "Input", "Udvid",
"Vælg" osv.
- Angiv klart grænsefladetekst til underordnede etiketter ved at bruge anførselstegn, så brugere kan skelne instruktionstekst fra grænsefladetekst, som de skal finde og reagere på.
- Hvert underordnet element skal være ansvarlig for én atomisk opgave, f.eks. input af en værdi.
- Tilføj altid et <onCompletion>-element til det sidste trin i et snydeark.
- Test snydeark med forskellige størrelse i oversigten snydeark.
- Test snydeark i fejllogsoversigten, så du kan se de advarsler, der er skrevet til loggen.
Retningslinjer for oprettelse af et sammensat snydeark.
- Et snydeark skal indeholde opgaver med relation til et fælles tema.
- Hver opgave i et sammensat snydeark skal have et veldefineret mål.
- Brug <onCompletion>-elementer til at kontrollere, at opgaven er udført.
- Opgavenavne bør være korte og præcise.
- Komplekse problemer kan løses ved at bruge opgaver, der bygger på de forudgående opgaver.
- Brug skip="true", hvis en opgave er valgfri.
- Sørg af hensyn til konsistens for, at introduktion til og navn på det enkle snydeark matcher introduktion og navn i det sammensatte snydeark.
- Angiv grænsefladetekst klart med fed skrift i opgavebeskrivelser.
- Sekvenser skal kun anvendes, når det er vigtigt at bevare en rækkefølge, som opgaverne kan startes i.
Relaterede link
Arbejd med snydeark
Arbejd med sammensatte snydeark
Enkle snydeark
Sammensatte snydeark