Light-Bulb icon by Till Teenck.svg Samsynwikin reder ut begreppen. Här presenteras de väsentligaste orden för universitetens samverkan. Definitionerna mognar olika snabbt och vi tar gärna emot respons för att utveckla dem vidare. Skapa ditt användarkonto här alternativt maila till samsyn(at)su.se. Mer information: Huvudsidan.

Samsyn:Stilguide: Skillnad mellan sidversioner

Från Samsyn
Hoppa till navigering Hoppa till sök
(Något anpassad för ev användare utanför projektgruppen.)
Rad 1: Rad 1:
{{Instruktionssida}}
{{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. Stilguiden fungerar som en beskrivning över vad målet är med en begreppssida och fylls på successivt under projektets gång för att dokumentera det som projektet Samsyn kommer underfund med. Som ett stöd för att planera, skriva och ge återkoppling om samverkansbegrepp i wikin finns också en [[Samsyn:Checklista|checklista]] som utgår från vad som finns i denna stilguide.   
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. Som ett stöd för att planera, skriva och ge återkoppling om samverkansbegrepp i wikin finns också en [[Samsyn:Checklista|checklista]] som utgår från vad som finns i denna stilguide.   


Sidan 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.  
Sidan 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.  


==Avgränsning==
==Avgränsning==
Samsyns wiki samlar begrepp som berör '''universitets och högskolors samverkan'''. Om ett begrepp går att beskriva utifrån denna riktlinje så hör det hemma i wikin. Vissa begrepp är gränsfall, då kan det behöva lyftas för en diskussion med andra i projektet för att reda ut om det ska ingå eller ej. Universitets och högskolors samverkan som tydligt tema kan också verka som vägledande för hur lång en sida kan bli, eller vad som bör ingå i begreppets beskrivning och inte. Här kan det vara till hjälp att sträva efter att "hålla sig till ämnet". När ett stycke eller detalj kan sägas vara alltför löst kopplat till det övergripande temat, kan det finnas anledning att stryka det från att ingå i wikin.
Samsyns wiki samlar de mer r'''elevanta och aktuella begrepp som berör universitets och högskolors samverkan'''. Vissa begrepp är gränsfall, då kan Samsynprojektets arbets- o/e styrgrupp ta beslut om det ska ingå eller ej.
 
==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==
==Dispositionen==
[[Fil:Screenshot-2017-12-12 Utadjungering smalare - Wikimedia.png|miniatyr|Exempel på hur en begreppssida kan se ut med definitionen i inledningen och sedan de andra delarna under respektive rubrik (klicka för förstoring).]]
[[Fil:Screenshot-2017-12-12 Utadjungering smalare - Wikimedia.png|miniatyr|Exempel på hur en begreppssida kan se ut med definitionen i inledningen och sedan de andra delarna under respektive rubrik (klicka för förstoring).]]
Varje samverkansbegrepp ska på sin beskrivningssida ha följande rubriker eller stycken.   
Varje samverkansbegrepp ska på sin beskrivningssida ha (åminstone) följande rubriker eller stycken.   


===Begreppet===
===Begreppet===
Rad 19: Rad 16:


===Definition (inledning)===
===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 inleder hela texten. Inledningen är det stycke text som föregår innehållsförteckningen.
Begreppssidans inledande stycke innehåller begreppets kortare och mer allmängiltiga definition inom universitets- och högskolors samverkanssammanhang. (Detta stycke har ingen rubrik eftersom det är sidans titel -  själva begreppet utgör rubriken och inleder hela texten.)
Inledningen bör vara kort och koncis och samtidigt ge det nödvändiga sammanhanget.  
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 eller högskola under en begränsad period och på deltid arbetar eller på annat sätt närvarar hos en arbetsgivare utanför akademin.”
::Exempel: “'''Självständigt arbete''' (examensarbete) är en akademisk uppsats i vilken studenten ska genomföra och redovisa ett mindre forskningsprojekt. Ett självständigt arbete kan genomföras i samverkan med externa aktörer.”


===Tillämpningar===
===Tillämpningar===
Efter den inledande definitionen lägger vi in rubriken "Tillämpningar". I det stycket skriver vi in en mer utförlig beskrivning av hur begreppet används, inom olika delar av högskolans verksamheter eller av våra samverkansparter. Vi kan ta upp avgränsningar 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.  
Efter den inledande definitionen lägger vi in rubriken "Tillämpningar". Där ges en mer utförlig beskrivning av hur begreppet används idag, inom olika delar av högskolans verksamheter eller av våra samverkansparter. Vi kan ta upp avgränsningar mot närliggande begrepp inom samverkan, även motsatta begrepp kan tas upp. Ge gärna konkreta exempel för tydlighetens skull. Har begreppet genomgått någon känd förändring eller har en känd uppkomst är det också relevant i detta avsnitt. Observera att allt måste ha källhänvisningar och att vi inte ska föra fram egna åsikter eller liknande.  


===Motsvarighet i engelskan===
===Motsvarighet i engelskan===
Ange den engelska motsvarigheten. Skriv först in rubriken "Engelska motsvarighet".  Skriv det engelska ordet i kursiv för att göra texten läsvänlig. Vi använder den brittiska engelskan med tanke på vårt EU-sammanhang och ESG-standard.   
Ange den engelska motsvarigheten. Skriv först in rubriken "Engelska motsvarighet".  Skriv det engelska ordet i kursiv för att göra texten läsvänlig. Vi använder den brittiska engelskan med tanke på vårt EU-sammanhang och ESG-standard.   


::Exempel: Utadjungering motsvarar engelskans ''Adjunct'' eller ''affiliated professor'' (eller teacher, researcher och så vidare).
::Exempel: Den engelska motsvarigheten för ett självständigt arbete på grundläggande nivå är '''''undergraduate projec''t'''. Motsvarande för ett arbete på avancerad nivå är '''''thesis'''''.


===Referenser===
===Referenser===
De referenser som har '''fotnoter''' i texten listas automatiskt under denna rubrik som en referenslista. Vi försöker att undvika fotnoter i texternas inledande definition för att i stället placera dem i avsnittet under rubriken tillämpningar. Via "Ange källa" finns tre olika referensmallar som kan användas beroende på vad källan är, dessa är "webbref", "bokref" eller "tidskriftref".  
De referenser som har '''fotnoter''' i texten listas automatiskt under denna rubrik som en referenslista. Undvik fotnoter i texternas inledande korta definition för att i stället placera dem i avsnittet under rubriken tillämpningar. Via "Ange källa" finns tre olika referensmallar som kan användas beroende på vad källan är, dessa är "webbref", "bokref" eller "tidskriftref".  
<div style="text-align: left;border:3px solid #cae1e7; padding:1.5em;">
<div style="text-align: left;border:3px solid #cae1e7; padding:1.5em;">
'''Webbplats:'''
'''Webbplats:'''
Rad 76: Rad 73:
*skriva ut förkortningar (Universitetskanslersämbetet och inte UKÄ, högskolepoäng och inte hp)
*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)
*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
*använda ett vanligt språkbruk, undvik svårtillgängliga eller alltför akademiska formuleringar
 
==Sätt att bidra (revidera, ge tips, ange åtgärdsbehov)==
Alla som vill bidra till artiklarnas innehåll eller utformning är välkomna att göra det! Det är wikins själva livsnerv att ta vara på. Det finns några olika sätt att bidra:
 
* Samtliga artiklar kan '''revideras direkt i texten''' av alla med ett användarkonto (enkelt att själv skapa). 
* Artiklarna har en bakomliggande sida, '''''Diskussion''.''' Där man kan skriva in tips, förslag eller tankar som artikelförfattaren sedan kan ta sig an. 
* Med '''''Åtgärd behövs''''' kan   
 
Det är den ursprunglige artikelförfattaren som har det primära ansvaret för artikelns innehåll och utformning. 


==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.  
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.  


Rad 91: Rad 96:


:*Behöver referenser
:*Behöver referenser
:*Behöver engelsk översättning
:*Behöver språkkorrektur
:*Behöver språkkorrektur
:*Behöver länkar
:*Behöver länkar
Rad 104: Rad 108:


*Läs mer om hur [[Mall:Åtgärd behövs|"Åtgärd behövs"]] läggs till i en sida.
*Läs mer om hur [[Mall:Åtgärd behövs|"Åtgärd behövs"]] läggs till i en sida.
==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.




{{Samsyn navbox}}
{{Samsyn navbox}}

Versionen från 11 september 2019 kl. 15.08



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. Som ett stöd för att planera, skriva och ge återkoppling om samverkansbegrepp i wikin finns också en checklista som utgår från vad som finns i denna stilguide.

Sidan 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.

Avgränsning

Samsyns wiki samlar de mer relevanta och aktuella begrepp som berör universitets och högskolors samverkan. Vissa begrepp är gränsfall, då kan Samsynprojektets arbets- o/e styrgrupp ta beslut om det ska ingå eller ej.

Dispositionen

Exempel på hur en begreppssida kan se ut med definitionen i inledningen och sedan de andra delarna under respektive rubrik (klicka för förstoring).

Varje samverkansbegrepp ska på sin beskrivningssida ha (åminstone) följande rubriker eller stycken.

Begreppet

Begreppet utgör själva titeln på sidan och bör vara i verbets infinitiv eller om substantiv i obestämd form. Om sidans titel innehåller ett fel går det att ändra genom att flytta sidan.

Definition (inledning)

Begreppssidans inledande stycke innehåller begreppets kortare och mer allmängiltiga definition inom universitets- och högskolors samverkanssammanhang. (Detta stycke har ingen rubrik eftersom det är sidans titel - själva begreppet utgör rubriken och inleder hela texten.) Inledningen bör vara kort och koncis och samtidigt ge det nödvändiga sammanhanget.

Exempel: “Självständigt arbete (examensarbete) är en akademisk uppsats i vilken studenten ska genomföra och redovisa ett mindre forskningsprojekt. Ett självständigt arbete kan genomföras i samverkan med externa aktörer.”

Tillämpningar

Efter den inledande definitionen lägger vi in rubriken "Tillämpningar". Där ges en mer utförlig beskrivning av hur begreppet används idag, inom olika delar av högskolans verksamheter eller av våra samverkansparter. Vi kan ta upp avgränsningar mot närliggande begrepp inom samverkan, även motsatta begrepp kan tas upp. Ge gärna konkreta exempel för tydlighetens skull. Har begreppet genomgått någon känd förändring eller har en känd uppkomst är det också relevant i detta avsnitt. Observera att allt måste ha källhänvisningar och att vi inte ska föra fram egna åsikter eller liknande.

Motsvarighet i engelskan

Ange den engelska motsvarigheten. Skriv först in rubriken "Engelska motsvarighet". Skriv det engelska ordet i kursiv för att göra texten läsvänlig. Vi använder den brittiska engelskan med tanke på vårt EU-sammanhang och ESG-standard.

Exempel: Den engelska motsvarigheten för ett självständigt arbete på grundläggande nivå är undergraduate project. Motsvarande för ett arbete på avancerad nivå är thesis.

Referenser

De referenser som har fotnoter i texten listas automatiskt under denna rubrik som en referenslista. Undvik fotnoter i texternas inledande korta definition för att i stället placera dem i avsnittet under rubriken tillämpningar. Via "Ange källa" finns tre olika referensmallar som kan användas beroende på vad källan är, dessa är "webbref", "bokref" eller "tidskriftref".

Webbplats: Exempel på källhänvisning för webref.[1]
Tidskrift: Exempel på källhänvisning för tidskrift.[2]

  1. ”Textens titel”. Utgivaren. https://www.riksdagen.se/sv/dokument-lagar/dokument/svensk-forfattningssamling/hogskolelag-19921434_sfs-1992-1434. Läst 23 september 2018. 
  2. Författarens namn (2018). ”Artikelns rubrik”. Tidskriftens namn (Utgivaren). 

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:

instruktionssidan finns instruktionerna för att lägga till

Textursprung

När texter kopieras, helt eller delvis, ska det anges med mallen Textursprung.

Externa länkar

Artiklarnas relation till webbplatser utanför wikin hanteras genom externa länkar. Att skilja på wikilänkar och externa länkar är viktigt, just vad gäller att bygga ett nät. Externa länkar inne i själva artiklarna drar bort läsaren från wikin och iväg till andra webbplatser. Alla externa länkar bör därför placeras längst ner i artikeln, inte inne i den.

Externa länkar placeras under rubriken "Externa länkar" (i pluralis), även om där bara finns en länk.

Länkar till webbsidor som utgör källor till artikeln räknas inte som "externa länkar", och ska istället vanligtvis ligga i avsnittet Referenser.

/Kopierat från Wikipedias rekommendationer/

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 svårtillgängliga eller alltför akademiska formuleringar

Sätt att bidra (revidera, ge tips, ange åtgärdsbehov)

Alla som vill bidra till artiklarnas innehåll eller utformning är välkomna att göra det! Det är wikins själva livsnerv att ta vara på. Det finns några olika sätt att bidra:

  • Samtliga artiklar kan revideras direkt i texten av alla med ett användarkonto (enkelt att själv skapa).
  • Artiklarna har en bakomliggande sida, Diskussion. Där man kan skriva in tips, förslag eller tankar som artikelförfattaren sedan kan ta sig an.
  • Med Åtgärd behövs kan

Det är den ursprunglige artikelförfattaren som har det primära ansvaret för artikelns innehåll och utformning.

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]
(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 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"

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.


Sida Mall:Navbox/styles.css måste ha en innehållsmodell "Sanerad CSS" för TemplateStyles (nuvarande modell är "wikitext").