Samsyn:Stilguide
Stilguide Instruktionssida
Den här stilguiden anger riktlinjer om vad som är lämplig stil för både språk och form för samverkansbegreppens beskrivningar på denna wiki. Den tar också upp hur man kan markera olika åtgärdsbehov och “vad som finns kvar att göra” för att en begreppssida ska bli så komplett som möjligt.
Om sidans innehållsförteckning
Wikins mjukvara genererar automatiskt en innehållsförteckning när sidan har minst fyra rubriker. Se exempelvis innehållsförteckningen på denna sida.
Dispositionen
Varje samverkansbegrepp ska på sin beskrivningssida ha följande rubriker för de mest grundläggande avsnitten.
Begreppets form
Begreppet utgör själva titeln på sidan och bör vara i verbets infinitiv eller om substantiv i obestämd form.
Definition (inledning)
Begreppssidans inledande stycke innehåller begreppets kortare och mer allmängiltiga definition. Detta stycke har ingen rubrik eftersom det är sidans titel - själva begreppet utgör rubriken och nleder hela texten. Inledningen är det stycke text som föregår innehållsförteckningen. Inledningen bör vara kort och koncis och samtidigt ge det nödvändiga sammanhanget.
- Exempel: “Utadjungering inom universitets- och högskolesektorn är när en lärare eller forskare från ett universitet/högskola under en begränsad period och på deltid arbetar eller på annat sätt närvarar hos en arbetsgivare utanför akademin.”
Tillämpningar
Efter den inledande definitionen finns utrymme att under en ny rubrik, "Tillämpningar", ge en mer utförlig beskrivning av hur begreppet används inom olika delar av högskolans verksamheter och vilka avgränsningar som kan göras mot närliggande begrepp inom samverkan, även motsatta begrepp kan tas upp. Exempel kan användas för tydlighet om det behövs. Har begreppet genomgått någon känd förändring eller har en känd uppkomst är det också relevant i detta avsnitt.
Motsvarighet i engelskan
Ange de engelska motsvarigheterna i kursiv för att göra texten läsvänlig.
- Exempel: Utadjungering motsvarar engelskans Adjunct eller affiliated professor, teacher, researcher.
Referenser
Under denna rubrik kommer de referenser som har fotnoter i texten automatiskt listas som en referenslista. Vi försöker att undvika fotnoter i texternas inledning för att i stället placera dem i avsnittet under rubriken tillämpningar.
Exempel på listade källhänvisningar från fotnot[1]:
Dessutom är detta platsen för att lista övriga referenser som texten bygger på, även om de inte hänvisas till med fotnot. När källorna listas använder Samsyns wiki systemet:
- Efternamn, Förnamn (årtal) Publikationens titel (länkad med extern länk).
Exempel på litteraturlista med källhänvisningarna:
- Stockholms universitet (2017) Samverkan vid Stockholms universitet
- Nationalencyklopedin - Uppslagsord uppdragsforskning
- Brunnström, Gustafsson och Jönsson (2017) Samverkan inom forskning – Malmö universitets arbete med att understödja, följa upp och utveckla forskningssamverkan.
På instruktionssidan finns instruktionerna för att lägga till
Externa länkar
Under den här rubriken punktlistas externa länkar till resursmaterial som anknyter till begreppen, men som inte passar som källhänvisning i själva löptexten. Externa länkar kan gå leda till (ge exempel här).
Språkliga riktlinjer
Begreppssidans innehåll ska kunna förstås av någon som inte vardagligen rör sig inom högskolesektorn. Därför är det bra att:
- skriva ut förkortningar (Universitetskanslersämbetet och inte UKÄ, högskolepoäng och inte hp)
- förklara det som internt i utbildningssektorn uppfattas som självklart (skillnad på kurs och program, rektors ansvar vid ett universitet ansvar jämfört med inom grundskolan)
- använda ett vanligt språkbruk, undvik helst högtravat eller alltför akademiska formuleringar
Att ange åtgärdsbehov
Det är sällan en lätt uppgift att åstadkomma en komplett begreppsbeskrivning på första försöket. Det är mycket enklare att successivt arbeta fram beskrivningens olika delar och växelvis gå från att granska texten till att lägga till mer innehåll. Och att låta den uppgiften cirkulera bland flera ögonpar.
För att markera var olika behov finns för ett begrepp så går det att markera detta genom lägga in en mall om att åtgärd behövs.
- Exempel
- "Samverkan är det viktigaste som finns."[Åtgärd behövs]
- Exempel
(Rör muspekaren över länkarna för att få förklaring om vilken åtgärd som behövs.)
Sådana markeringar underlättar för andra att se vilka hål som finns att fylla, och det grupperar också olika begrepp som har åtgärdsbehov vilket underlättar arbetet och arbetsfördelningen. Markeringarna ska ses som minneshjälp över “vad som är kvar att göra”.
Exempel på åtgärder kan vara följande:
- Behöver referenser
- Behöver engelsk översättning
- Behöver språkkorrektur
- Behöver länkar
Att en projektdeltagare anser att det finns ett behov och markerar det betyder inte att det är samma person som ansvarar för åtgärden. Markeringarna ska vara ett sätt att samarbeta och underlätta det iterativa arbetssättet i samsynwikin.
Alla begrepp som är markerade för något av de här åtgärdsbehoven kan samlas upp.
Instruktioner för att ange "Åtgärd behövs"
- Läs mer om hur "Åtgärd behövs" läggs till i en sida.