Skip to content

Commit e0dc898

Browse files
trubbCactooz
authored andcommitted
Fromat files with markdownlint, update README.md
1 parent 9c51b29 commit e0dc898

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

53 files changed

+964
-655
lines changed

README.md

+25-25
Original file line numberDiff line numberDiff line change
@@ -1,37 +1,37 @@
11
# styrdokument
2-
Regulatory documents belonging to the Chapter for Information- and Nanotechnology
3-
4-
Use [Pandoc](http://pandoc.org/) for converting .md files to PDFs.
52

6-
```pandoc document.md -o example.pdf```
3+
Regulatory documents belonging to the Chapter for Information- and Nanotechnology, written in Markdown.
4+
The compiled documents are available in PDF form under [the repository's "**Releases**" page](https://github.com/insektionen/styrdokument/releases)
75

8-
See [Markdown Cheat sheet](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet) for an introduction to markdown syntax.
6+
See [Markdown Cheat sheet](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet) for an introduction to Markdown syntax.
97

8+
A more in-depth introduction to writing Markdown is provided [here by GitHub](https://docs.github.com/en/get-started/writing-on-github).
109

11-
## Repository rules!
12-
1. **ONE SENTENCE PER LINE** - in order to make it easier to refer to specific changes, sentences, or places in the files.
13-
2. **ONLY PULL REQUESTS MAY CHANGE THE MAIN BRANCH** - in order to make sure that we are *all* accountable, and that it is easy to audit historical changes.
10+
You should conform to GitHub Flavored Markdown (GFM) when editing these documents, [the formal specification for that dialect can be found here](https://github.github.com/gfm/).
11+
12+
## Repository rules
13+
14+
1. **ONE SENTENCE PER LINE** - in order to make it easier to refer to specific changes, sentences, or sections of text in the files.
15+
2. **ONLY PULL REQUESTS MAY CHANGE THE MAIN BRANCH** - in order to make sure that we are *all* accountable, and that it is easy to audit historic changes.
1416
3. **ALL PULL REQUESTS MUST BE ACCOMPANIED BY A MOTION OR PROPOSITION** - as the chapter meeting must approve all changes to the regulatory documents.
1517
4. **PROPOSED CHANGES ARE MADE BY CLONING THE REPO AND THEN CREATING A PULL REQUEST** - in addition to #2, direct changes to this repo should be avoided as far as possible.
16-
5. **PDF VERSIONS OF THE DOCUMENTS ARE PROVIDED AS RELEASES, NOT WITHIN THE REPO** - new changes or additions: new release.
17-
18+
5. **PDF VERSIONS OF THE DOCUMENTS ARE PROVIDED AS RELEASES, NOT WITHIN THE REPO** - new changes or additions -> new release, this is automated via GitHub Actions.
1819

1920
## Writing motions or propositions and using this repository
21+
2022
When writing a motion or proposition that changes some regulatory document, do the following:
23+
2124
1. Fork this repository
2225
2. Perform the changes that are part of the motion *in your own fork*, **not** in this repository or any of its branches.
2326
3. Create a pull request in this repository, link to and briefly describe your motion in the pull request.
2427
4. Link to the pull request in your motion; and in the motion explicitly state which line(s) in the affected file(s) that you want to change.
2528
5. Any additions or changes to the proposed changes are done as suggested changes in the pull request on GitHub.
2629

27-
2830
## Repository structure
29-
```
31+
32+
```text
3033
├── archive - old regulatory documents
3134
├── img - images required by the regulatory documents
32-
│   ├── logo_in_600px.png
33-
│   ├── logo_in_monokrom_svart.png
34-
│   └── logospacing.png
3535
├── other_documents - regulations for clubs, the chapter's vision plan
3636
│   ├── eng
3737
│   └── swe
@@ -43,21 +43,21 @@ When writing a motion or proposition that changes some regulatory document, do t
4343
└── swe
4444
```
4545

46-
## Tips and tricks:
47-
- Use a PDF merging program to create the master PDF files.
48-
[https://pdfsam.org/](https://pdfsam.org/) is a good alternative.
49-
- Another alternative is to directly use Pandoc, this remains untested and should probably be part of some build script instead.
50-
Pandoc command: `pandoc -s input1.md input2.md input3.md -o output.pdf`
46+
## Tips and tricks
47+
48+
- If you are using VS Code, the plugin [markdownlint](https://marketplace.visualstudio.com/items?itemName=DavidAnson.vscode-markdownlint) greatly helps the editing process.
5149

50+
## A comment on performing minor changes such as correcting spelling
5251

53-
## A comment on performing minor changes
5452
All chapter secretaries are **strongly** urged to learn how to utilize editorial changes, this process is known as "redaktionella ändringar" in swedish.
55-
This greatly cuts down on the deluge of unnecessary propositions from the board that usually follows an plan to make miniscule changes to the chapter's regulatory documents.
56-
This does, however, **not** exempt you from rules #2 and #3.
53+
This greatly cuts down on the deluge of unnecessary propositions from the chapter's board that usually follows any read-through of, or plan to make miniscule changes to, the chapter's regulatory documents.
54+
This does, however, **not** exempt you from the repository's ruleset.
5755

56+
### And lastly
5857

59-
### And lastly:
60-
§2.1.3 of the chapter's statutes clearly state that you need to publish *all* of the chapter's regulatory documents on the chapter's website.
58+
§2.1.3 of the chapter's statutes clearly state that *all* of the chapter's regulatory documents must be published on *the chapter's website*.
59+
The release page, that each repository on GitHub has, is *not* the chapter's website.
60+
Do not use the release page of this repository as the sole storage of the regulatory documents.
6161
So, **if you lose these documents again I will find you!** [imagine a photo of Liam Neeson holding a cellphone]
6262
If you actually need *any* help with this repo, contact me, really.
6363
Signed, Ordf 2016
Original file line numberDiff line numberDiff line change
@@ -1,28 +1,24 @@
11
# Åsiktsdokument för IN-sektionen
22

33
## Om rekrytering
4+
45
Det är knappast en nyhet att intresset för teknik har gått ner bland studenter.
56
För att råda bot på detta krävs en relevant och fungerande rekryteringsfilosofi samt fungerande rekrytering.
67
Samtidigt är det viktigt att se att olika utbildningar har olika behov av insatser för att stärka rekryteringen och öka intresset.
78

89
**Sektionen för informations och nanoteknik anser att:**
910

1011
- program på KTH skall namnges på ett sådant sätt att det framgår vad utbildningen syftar till.
11-
1212
- det bör vara möjligt att göra reklam för enskilda utbildningar där efterfrågan idag är låg.
13-
1413
- KTH:s skolor bör ha större makt över utformningen av rekryteringen till de utbildningar som bedrivs vid skolan.
15-
1614
- KTH bör vara drivande i att få upp intresset för teknikämnet bland elever på grund och gymnasienivå.
17-
1815
- KTH bör använda sig av riktade rekryteringsinsatser mot underrepresenterade grupper.
19-
2016
- KTH bör undvika att associera KTH enbart med KTH:s campus vid Valhallavägen.
21-
2217
- KTH skall inte kalla KTH:s campus vid Valhallavägen för campus KTH eller liknande.
2318

2419
### Om pedagogik, lärande, kurs och programutformning
25-
Utbildning på en så hög nivå som den som bedrivs vid KTH ställer krav på att undervisande lärare har en förståelse för pedagogik.
20+
21+
Utbildning på en så hög nivå som den som bedrivs vid KTH ställer krav på att undervisande lärare har en förståelse för pedagogik.
2622
Nivån på pedagogisk förmåga är däremot väldigt varierad bland den undervisande personalen.
2723
Det finns exempel på underbara pedagoger men även på lärare som inte ens tycks förstå vad ordet innebär.
2824
Att så är fallet kan delvis förklaras av att universitetet både sysslar med utbildning och forskning och det är ofta fallet att båda dessa kompetenser inte återfinns i samma person.
@@ -36,34 +32,22 @@ Därtill är det viktigt att studenten har en stor förmåga att forma innehåll
3632
**Sektionen för informations och nanoteknik anser att:**
3733

3834
- utbildningen på KTH bör ha en hög pedagogisk nivå.
39-
4035
- för anställning eller befordran till ordinarie lärartjänst vid KTH skall krävas pedagogisk kompetens motsvarande 15 högskolepoäng högskolepedagogik.
41-
4236
- adjungerade lärare ska inte få vara ensamt ansvariga för kurser om de inte kan styrka pedagogisk skicklighet på samma nivå som den motsvarande ordinarie tjänsten.
43-
4437
- undervisande personal skall ha fortlöpande fortbildning i pedagogik
45-
4638
- pedagogiska meriter skall vara lönegrundande för lärare vid KTH.
47-
4839
- vid tjänstetillsättning skall krav ställas på att läraren kan tala god engelska eller god svenska samt tillfredsställande engelska.
49-
5040
- lärare skall enbart undervisa på språk de har dokumenterade färdigheter i.
51-
5241
- utbildning på kandidatnivå även inom civilingenjörsprogrammet skall utformas så att de kan vara en självständig och fullgod utbildning, oberoende av eventuella vidare studier på masternivå.
53-
5442
- utbildning på kandidatnivå skall ha en så stor del av valbara eller villkorligt valbara kurser att studenten skall ha ett stort urval av efterkommande mastersprogram utan behov av komplettering.
55-
5643
- ingångsnivån på KTH:s utbildningar ska styras av behörighetskraven, såtillvida att studierna inte får förutsätta underförstådda kunskaper eller erfarenheter.
57-
5844
- studenten bör erbjudas möjlighet att delta i forskningen som sker på KTH.
59-
6045
- undervisningen ska bedrivas på solid vetenskaplig grund eller etablerad praxis i ett yrkesperspektiv.
61-
6246
- näringslivet bör ha inflytande över utformning av program och kursutformning.
63-
6447
- studenter skall ha tillgång till kompetent och tillgänglig studievägledning.
6548

6649
## Om Kurser, kursmål och examination
50+
6751
I och med Bolognaprocessen har KTH övergått till en sjugradig målrelaterad betygssättning.
6852
I och med detta ställs något högre krav på både utformningen av kurser, kursmål och examination.
6953
Betygsmålen i en kurs skall bygga på de kursmål en kurs har, detta innebär två viktiga insikter.
@@ -82,41 +66,30 @@ Flertalet kurser är redan anpassats till detta men fortfarande finns många kur
8266
**Sektionen för informations och nanoteknik anser att:**
8367

8468
- betygssättning på KTH skall vara målrelaterad.
85-
8669
- examination av kurser skall utformas så att dessa kan mäta de mål som är uppställda för kursen.
87-
8870
- I kurser där mål inte examineras bör antingen mål eller examination omformas.
89-
9071
- andra examinationsformer än skriftlig salstentamen bör uppmuntras.
91-
9272
- praktiska, laborativa och andra utbildningsmoment än föreläsningar bör uppmanas.
93-
9473
- tydliga regler och riktlinjer behövs för andra examinationsformer än skriftlig tentamen för att möjliggöra öka användande av dessa samt garantera studenternas rättssäkerhet.
95-
9674
- en examinationsform bör aldrig väljas enbart med motiveringen att den är enkel eller billig att tillämpa.
97-
9875
- examination skall inte utformas så att den till stor del examinerar mål som inte är uppställda för kursen eller som inte kan anses vara förkunskapskrav för kursen.
99-
10076
- lärare med ansvar för utformning av kurser och examination skall ges relevant utbildning för att kunna utforma kurser på ett korrekt sätt.
10177

10278
## Om jämställdhet, mångfald och likabehandling
79+
10380
Nedan refererar diskrimineringsgrunderna till kön, könsöverskridande identitet eller uttryck, etnisk tillhörighet, religion eller annan trosuppfattning, funktionshinder, sexuell läggning eller ålder.
10481

10582
**Sektionen för Informations- och Nanoteknik anser att:**
10683

10784
- alla medlemmar ska ha samma rättigheter och möjligheter att söka poster i sektionen, oavsett tillhörande diskrimineringsgrund.
108-
10985
- fördomar om sociala beteenden baserade på någon diskrimineringsgrund ej ska förekomma i sektionens eller KTHs verksamhet.
110-
11186
- språket i sektionens och KTHs verksamhet ska vara inkluderande.
112-
11387
- statistik som tyder på att grupper efter någon diskrimineringsgrund särbehandlas i sektionen eller på KTH ska tas i beaktning och utredas.
114-
11588
- allt arbete i sektionen och på KTH ska vara jämställt, ta hänsyn till mångfaldsaspekter och vara likabehandlande.
11689

11790
## Om Sekretess
91+
11892
**Sektionen för Informations- och Nanoteknik anser att:**
11993

12094
- skolan ska behandla personuppgifter om studenter med varsamhet.
121-
12295
- sektionen ska behandla personuppgifter om studenter med varsamhet samt endast använda dem i angivna syften.
+8
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,32 @@
11
# Directive for Hattklubben
22

33
## 1 Formalities
4+
45
### 1.1 Purpose
6+
57
The purpose of this directive is to regulate the hat club *Hattklubben*.
68
Hattklubben aims to promote the wearing of hats among the chapter's members.
79

810
### 1.2 History
11+
912
Established: 2013-10-23
1013
Last revision: 2013-10-23
1114

1215
## 2 Organisation
16+
1317
### 2.1 Hattklubben's chairperson
18+
1419
The chairperson of Hattklubben shall be the member of Hattklubben wearing the largest number of hats at any given monment.
1520

1621
### 2.2 Membership
22+
1723
In order to become a member of Hattklubben it shall be required that one be a Chapter member and that one is wearing at least one (1) hat.
1824
The membership is valid as long as the member is wearing at least one (1) hat.
1925

2026
## 3 Hats
27+
2128
Hattklubben defines a hat concerning membership and chairpersonship as an object worn on a head.
2229

2330
## 4 Motto
31+
2432
Hattklubben's motto is and shall remain *Hattar när det händer*.
+5
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,25 @@
11
# Direktiv för Strängteoretiquerna
22

33
## 1 Formalia
4+
45
### 1.1 Syfte
6+
57
Detta direktiv är avsett att reglera klubben Strängteoretiquerna.
68

79
Strängteoretiquerna är en klubb tillhörande Sektionen för Informations- och Nanoteknik som syftar till att främja bevarande och skapande av studentqultur.
810

911
### 1.2 Historik
12+
1013
Upprättat: 2014-06-06
1114
Senast ändrat: 2014-06-06
1215

1316
## 2 Organisation
17+
1418
Strängteoretiquerna leds av de två språkrören Bellman och Fredman.
1519
Dessa två godkänns av sektionsmötet.
1620

1721
## 3 Verksamhet
22+
1823
Strängteoretiquernas verksamhet regleras under eget reglemente vilket är en del av denna PM.
1924

2025
Detta reglemente ändras i enlighet med bestämmelser i nämnda reglemente.

other_documents/eng/visionsplan.md

+3-13
Original file line numberDiff line numberDiff line change
@@ -4,40 +4,30 @@ This document regulates the visions of the Chapter for Information- and Nano Tec
44
The document shall be updated annually by the board.
55
The goals shall act as a guide for the chapter's work.
66

7-
# Members
7+
## Members
88

99
- All students at KTH Kista are members in the chapter.
10-
1110
- All students at KTH Kista feles personally welcome and appriciated in the chapter.
12-
1311
- All students at KTH Kista benefit from the chapter.
14-
1512
- All students at KTH Kista have a sense of belonging to the chapter, THS, and KTH.
16-
1713
- All chapter members has a good time during their spare time when they are not studying.
1814
Nobody should sit at home and be involontarily bored but there should always be a fun event they can attend.
19-
2015
- All chapter members know what the chapter does and is working towards.
2116

2217
## Active members
2318

2419
- All of the chapter's trustees knows what the previous year's trustees have done and what has yet to be done.
25-
2620
- All those who works for the chapter feel appriciated.
27-
2821
- The chapter has a god work environment for those who are active.
29-
3022
- All those who works for the chapter have a reasonable work load.
31-
3223
- The chapter is a place where students can realise their dreams.
3324

3425
## Education
3526

3627
- All students at KTH Kista are satisfied whith their education.
37-
3828
- All courses at KTH Kista have a course committe.
39-
4029
- The chapter and the ICT school have an open dialog and a working internal communication.
4130

42-
# Externally
31+
## Externally
32+
4333
- All students feel welcome and well recieved in the chapter.

0 commit comments

Comments
 (0)