Ny modul om kodelister i introkurset

[TomasEng]

Har lagt til en modul om kodelister i det oppdaterte introkurset, i tillegg til å ta en liten språkvask i eksisterende moduler og kodelisteguiden.

[Ildest]

Da er jeg ferdig med gjennomgangen @TomasEng. Det er ganske mye, siden jeg også har revidert det som ikke handlet om kodelister. Noen punkter å ta hensyn til:

• Bruk "du" ikke "man" i instrukspunkter. I generelle deler kan vi bruke "vi", slik det er brukt noen steder her.
• Ha ett punkt (ett gjøremål) per instrukslinje.
• Jeg foreslår å ha overskriften unummerert og heller ha flere mellomoverskrifter for å unngå lange instrukser. En prosedyre bør ikke ha mer enn fem punkter, maks sju. Vi har prosedyrer i vårt introkurs med over 20 punkter, da mister vi leseren tidlig, de må ofte refokusere midt i for å huske hvor langt de har kommet.
• I overskriften rett før en trinnvis veiledning, bruk verbet i imperativ ("Legg til").
• I generelle overskrifter før forklarende tekst om et emne, bruk infinitiv av verbet ("Legge til").
• Når det gjelder denne revisjonen. - det ble mye fordi jeg tok tak i alt som sto her: Hvis du vil kan du oppdatere kun det som står om kodelister, og så kan vi overlate resten til en ny sak, og jeg kan oppdatere det som gjelder resten av kurset? Litt opp til deg, men forstår om du ikke har tid til å ta tak i alt dette.
• Fint om du leser korrektur på mine forslag når du går gjennom, det kan alltid være noen stavefeil, så da blir det en ekstra kvalitetssikring.
• Hvis du kan publisere etter at du har endret (har vi en testserver for publisering av dok?), tar jeg gjerne en test av det å legge til kodelister igjen, for å se at det fungerer slik det ble revidert.

[Ildest]

Nå tror jeg alle kommentarene, unntatt et par der jeg svarte deg, er løst.