Bidrag

Vil du skrive en guide?

Jeg modtager meget gerne udkast til guides. Denne side beskriver, hvordan du laver et godt udkast. Webmaster og skribent har det sidste ord at skulle have sagt. Det skyldes, at jeg gerne vil have en ensartet kvalitet i de mange guides på siden.

Skriv kun om programmer/emner, du har indgående kendskab til, da du ellers ikke kan skrive om de væsentligste emner og faldgruber, brugerne kan opleve.

Kom godt i gang

Det allervigtigste er, at du gør dig klart, at du skriver for alle mennesker. Nørderne klarer såmænd sig selv.

Denne vejledning kan synes “diktatorisk”, men det skyldes alene, at jeg gerne vil have, at de mange guides har en ensartet kvalitet.

Det er lidt af en kunst at skrive læsbare tekster på nettet, fordi vi læser helt anderledes på skærmen end i fx en bog eller en avis. Det vil sige, at man skal tænke meget over læsbarheden.

Niels Gamborg har beskæftiget sig meget med læsevenlige tekster på nettet. Det er altid hans råd, jeg følger. Her er en lærerig lille artikel, som du bør læse, inden du går i gang med din første guide.

En anden forfatter, der er god at kende til, når man skriver til nettet, er Jakob Nielsen. Her er en liste med hans arbejde med “usability”, som vel nærmest kan oversættes til “brugervenlighed” – desværre er listen kun på engelsk.

Når du afleverer din guide til mig, forbeholder jeg mig retten til at rette stavefejl, kommafejl, dele op i flere afsnit, reducere antallet af illustrationer mv. alt sammen af hensyn til kvalitet, overskuelighed og læsbarhed. Der er ikke noget så distraherende som tekster fyldt med fejl.

Starten på guiden

Afsnit 1: Start altid med at beskrive hvad programmet kan, og hvorfor det er en god idé at have det eller sagt på en anden måde ”Hvad er formålet”?

Afsnit 2: Koster programmet noget, eller er det gratis? Hvis det koster noget, skal du angive prisen og hvilket år, den er fundet.

Afsnit 3: skal være en henvisning til, hvor programmet kan hentes. Herunder er en liste over sider, du gerne må henvise til.

  • https://ninite.com/
  • http://www.majorgeeks.com/
  • https://sourceforge.net/
  • http://www.tucows.com/
  • https://www.fosshub.com/
  • http://filehippo.com/

Hent altid fra producenten, hvis det er muligt. Hvis producenten selv linker til andre sider, må det formodes, at linket er i orden.

Klik aldrig på “reklamer”. Undersøg siden du henter fra; i mange tilfælde “gemmer” linket sig lidt nede på siden. Det bør i givet fald fremgå af guiden

Vær opmærksom på “ekstra” – og som oftest unødvendig – software, når du installerer et program. Læs hvad der står på skærmbilledet og fjern eventuelle flueben, der er sat på forhånd.

Er du i tvivl, så lad være med at hente/installere; spørg i stedet i gruppen, om der findes sikre alternativer.

Afsnit 4: Beskrivelse af installationsprocessen. Hvor gemmer man den hentede fil? Hvad hedder filen? Hvad sker der, når man dobbeltklikker? Er det så bare næste, næste, næste? Hvis ikke hvad så? Er der særlige knapper, der skal trykkes på?

Når programmet kører
  1. Hvordan ser første skærmbillede ud? Evt. med illustration.
  2. Hvad gør man for at komme i gang med programmet?
  3. Er der evt. særligt vigtige punkter af være opmærksom på?
  4. Har du tips, som ikke fremgår af menuerne?
  5. Og meget mere som din erfaring med programmet siger dig.
Formater og illustrationer mv.

Jeg vil gerne have dit bidrag i Word, Libre Office eller hvad du nu bruger som tekstbehandlingsprogram, og illustrationer skal være indlejret, så jeg kan se hvor i teksten, du vil have dem. Jeg frabeder mig bidrag som pdf-filer, da det betyder, at jeg skal lave en masse cut’n paste over til Notesblok eller lignende.

Samtidig vil jeg gerne have billedfilerne i naturlig størrelse tilsendt på mail: webmaster@supportpcogandet.dk. Når jeg gerne vil have filerne særskilt, skyldes det, at de ofte bliver for små, når de er indlejrede, og det dur ikke. Hvis der skal være illustrationer, skal de også kunne ses. Hvis du har mulighed for at sætte pæne pile, der peger på vigtige elementer, er det godt, og ellers så sætter jeg dem på med ”Snagit”.

Du skal ikke levere 10 illustrationer, da det bliver uoverskueligt for læserne (og mig). To – tre stykker, der er essentielle, er fint. Det er teksten, der skal være det bærende.

Sprog

Du skal skive direkte til brugerne; derfor skal der fx stå “Du henter…”, “Du installerer…” osv.

Du skal stave rigtigt og sætte både punktummer og kommaer. Herudover skal afsnittene ikke være for lange. Det skyldes alt sammen hensynet til læsbarheden. Retter du ikke disse ting til, gør jeg det.

Du skal ikke bruge kancellisprog.

Du skal ikke bruge forkortelser men skrive ordene helt ud lige bortset fra selvfølgelig: fx, mm., mv., osv. og den slags.

Guiden skal være på dansk: ikke på pseudoengelsk. Det vil sige ikke ”Clean install” men ”ren installation”, ikke ”Download” men ”Hent”, ikke ”Install” men ”installere”, ikke ”site” men ”side”, ikke “admin” men “administrator”, ikke “add on” men “tilføjelse”, ikke “detektere” men “spore”, ikke “double click” men “dobbeltklik”, ikke “ISP” men “udbyder” osv.

Ingen smileys: Dine ord skal kunne forklare dit budskab i sig selv. Smileys gør teksten mindre seriøs.

Skriv ”stramt” uden overflødige ord.

Slang: Vi ”smider” ikke ting på nettet. Vi lægger. ”Smider” er slang, og det vil jeg ikke have.

Talord under 10 skrives med bogstaver, altså tre, fire, fem osv. 10 og derover skrives med tal. Tusindtalsseparator er punktum fx 1.000.

Hvis programmet hedder fx ”uBlock”, skal du skrive det på helt samme måde og være konsekvent hele vejen igennem.

Kategorisering

Det er dig, der kender programmet bedst, og derfor er det også dig, der skal hæfte en kategori på din guide, så den bliver vist det rigtige sted på hjemmesiden. Du kan benytte følgende kategorier:

  • Ad blockere
  • Afspilning
  • Billeder og video
  • Browsere, e-mail, tilføjelser mv.
  • Brænderprogrammer
  • Diverse – kun til “nødstilfælde”
  • Editorer
  • Facebook
  • Fjern vira – når du er ramt
  • FTP-programmer
  • Genskab data
  • Hjælpeprogrammer
  • Kommunikation
  • Kontorpakker
  • Mobiltelefoner
  • Onlinedrev
  • Sikkerhed – forebyggelse
  • Windows

Du skal oplyse om kategorien, når du sender e-mail med tekst og illustrationer.

Du skal også angive en lille kort beskrivelse, som vil blive vist lige under linket. Til højre ses fire eksempler på disse beskrivelser. De træder i kraft, når testen af den nye side er færdig.

Kategorien ”Diverse” findes og vises, men må kun bruges i ”nødstilfælde”, da den ellers bliver en ”skraldespand”, som kan bevirke, at brugerne mister overblikket, når de kigger i menuen.

Passer din guide ikke ind i nogen af disse kategorier, er du til enhver tid velkommen til at kontakte mig via mail, så vi kan få en dialog om en mulig ny kategori. Siden er for alle, og vi skal sikre, at alle kan finde rundt i de tilbud, vi har.

Proces
  1. Du sender dit udkast. Husk billederne og husk, at jeg ikke ønsker PDF-filer.
  2. Jeg kigger det igennem og sætter det op på en side.
  3. Jeg sender dig et link til siden, og du ser det igennem, og erklærer det for OK eller kommer med forslag til ændringer. Siden er på dette tidspunkt hemmelig, da den er ikke er knyttet til menuerne.
  4. Typisk har du glemt at tage stilling til kategorisering og beskrivelse.
  5. Hvis ovenstående stillingtagen mangler, kommer jeg med et forslag, som du skal godkende.
  6. Når jeg har svar fra dig, sætter jeg oplysningerne på, og linker siden til menuerne.
  7. Jeg annoncerer den nye guide i Facebookgruppen med startordene: “Ny guide: Fornavn, Efternavn har bidraget med en guide om: xxx. Den kan findes under kategorien (de blå) xxx, eller du kan klikke på linket herunder.
Afslutning og kontakt

Er du i tvivl om noget, svarer jeg altid gerne på spørgsmål. Du finder mig her:


Hanne B. Stegemüller, webmaster og skribent. 9. oktober 2017