Language in code

[sverl]

We should be consistent with the language in the code (also across branches). Shall we change all of the code (variable names and comments) to English?

[vegro90]

I think so! Even though the course should be lectured in Norwegian, I think it is nice to show that program code should be written in English to prevent "ÆØÅ"-errors. This should also be the case for file directories. e.g. the os-library in Python does not like directories with ÆØÅ 💢

[karolinf]

Min umiddelbare følelse er at hvis dette er kode studentene skal/kan forholde seg til, bør vi holde oss til norsk, og heller lage en tilgjengelig ordliste ved behov. Dette er delvis min personlige hang-up om at folk bør være i stand til å snakke fag på morsmålet sitt, men også fordi lov om høyere utdanning slår fast at bachelorundervisning skal foregå på norsk.

?

Hvis det er snakk om intern kode til dingsen, er det litt mer opp til dere, men studentene skal vel programmere mot dingsen, om en aldri så overflatisk?

Hva er gode argumenter for å bruke engelsk?

Vennlig hilsen Karoline

---

From: sverl notifications@github.com Sent: 07 July 2017 12:43 To: sloydsalen/KJM1101-exercises Cc: Subscribed Subject: [sloydsalen/KJM1101-exercises] Language in code (#2)

We should be consistent with the language in the code (also across branches). Shall we change all of the code (variable names and comments) to English?

- You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHubhttps://github.com/sloydsalen/KJM1101-exercises/issues/2, or mute the threadhttps://github.com/notifications/unsubscribe-auth/AQPLUrSFye0PBf5KDy_Zs8F3TN7gZ40Pks5sLgu9gaJpZM4OQyLV.

[karolinf]

?Jeg kjøper til en viss grad æøå-argumentet for variabler, selv om jeg tror det er fullt mulig å gjøre studentene oppmerksom på æøå-begrensningen uten å måtte skifte språk. Merker at jeg har lyst på norske kommentarer, men det blir kanskje bare forvirrende. Hva er praksis i INF1100?

---

From: Karoline Fægri Sent: 07 July 2017 13:01 To: sloydsalen/KJM1101-exercises; sloydsalen/KJM1101-exercises Cc: Subscribed Subject: Re: [sloydsalen/KJM1101-exercises] Language in code (#2)

Min umiddelbare følelse er at hvis dette er kode studentene skal/kan forholde seg til, bør vi holde oss til norsk, og heller lage en tilgjengelig ordliste ved behov. Dette er delvis min personlige hang-up om at folk bør være i stand til å snakke fag på morsmålet sitt, men også fordi lov om høyere utdanning slår fast at bachelorundervisning skal foregå på norsk.

?

Hvis det er snakk om intern kode til dingsen, er det litt mer opp til dere, men studentene skal vel programmere mot dingsen, om en aldri så overflatisk?

Hva er gode argumenter for å bruke engelsk?

Vennlig hilsen Karoline

---

From: sverl notifications@github.com Sent: 07 July 2017 12:43 To: sloydsalen/KJM1101-exercises Cc: Subscribed Subject: [sloydsalen/KJM1101-exercises] Language in code (#2)

We should be consistent with the language in the code (also across branches). Shall we change all of the code (variable names and comments) to English?

- You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHubhttps://github.com/sloydsalen/KJM1101-exercises/issues/2, or mute the threadhttps://github.com/notifications/unsubscribe-auth/AQPLUrSFye0PBf5KDy_Zs8F3TN7gZ40Pks5sLgu9gaJpZM4OQyLV.

[vegro90]

As stated above there is the issue with ÆØÅ in the compiler. Since the Python programming language is English, it makes sense to write all code in English ass well. Not only would the code look better when it's written only in one language, but it is also more readable. In my opinion, Norwegian have no place in program code!

The way I have understood the part about bachelor courses in Norwegian is that it only applies to the lectures and language on the exams. I guess the book is also in English?

[sverl]

If I recall correctly, Norwegian is just spoken in lectures and used in exam exercises. The lecture slides, code written in lectures, code in exam exercises and the book are all in English.

Here is a comparison of English vs "Norwegian" code:

# iterate through loop
length = 100
total = 0
for number in range(length):
    total += number

# iterer gjennom en loekke
lengde = 100
total = 0
for tall in range(lengde):
    total += tall

Or lines like this are even worse!

while volum_vaeske not in range(volum_maks) and stoekiometri is True:

Alternativly, code can actually use æøå, but that requires a magic comment at the start of the code and all strings need to be declared as unicode by being prefaced with a u.

[karolinf]

OK, jeg gir meg. Trodde den ikke brydde seg om æøå når det sto # foran (altså i kommentarene). Dessuten, hvis ifi kjører alle kommentarer på engelsk er det vel det de blir vant til?.

---

From: sverl notifications@github.com Sent: 07 July 2017 13:37 To: sloydsalen/KJM1101-exercises Cc: Karoline Fægri; Comment Subject: Re: [sloydsalen/KJM1101-exercises] Language in code (#2)

If I recall correctly, Norwegian is just spoken in lectures and used in exam exercises. The lecture slides, code written in lectures, code in exam exercises and the book are all in English.

Here is a comparison of English vs "Norwegian" code:

iterate through loop

length = 100 total = 0 for number in range(length): total += number

iterer gjennom en loekke

lengde = 100 total = 0 for tall in range(lengde): total += tall

Alternativly, code can actually use æøå, but that requires a magic comment at the start of the code and all strings need to be declared as unicode by being prefaced with a u.

- You are receiving this because you commented. Reply to this email directly, view it on GitHubhttps://github.com/sloydsalen/KJM1101-exercises/issues/2#issuecomment-313658370, or mute the threadhttps://github.com/notifications/unsubscribe-auth/AQPLUooOefZ5yyTvZdK7QR8PlQpWQaXrks5sLhiFgaJpZM4OQyLV.

[eirillsh]

IFI er delt. INF1010 hadde engelsk bok, men foreleserene hadde norske variabelnavn, kommentarer og klassenavn. Det ser rart ut med mye norske variabelnavn og klassenavn i koden spør du meg, men det er ikke et problem. For min del føles det rart å skulle skrive oppgavene på engelsk når de kun skal brukes på norsk universitet. Æ, Ø og Å er heller ikke et problem hvis du legger til " # -- coding: utf-8 -- " som kommentar øverst i programmet.

Jeg synes heller ikke det er problematisk med norsk oppgavetekst og engelske variabelnavn i koden. For mange er nok engelsk oppgavetekst helt greit, men det er nok studenter som hadde synes det er lettere med norsk. Engelsk er det internasjonale språket til kjemi, men det brukes jo for å nå ut til størst mulig publikum. Jeg synes det virker litt kunstig å skulle ha alt på engelsk.

Jeg har gjerne engelske variabelnavn og kommentarer til koden, men vil gjerne ikke skifte språk på de kommentarene i koden som ikke er "kommentarer", men en del av oppgavebeskrivelsen, som er på norsk.

[vegro90]

@eirillsh. Tenkte jeg kunne presisere for å ungå evt missforståelser. Her er det kun snakk om å skrive engelsk programkode(alt i kode-celler). Alt annet som oppgavetekst osv kan godt være på norsk 👍

[eirillsh]

Men en del av kommentarene mine regner jeg egentlig som en del av oppgaveteksten. Jeg kan legge inn kommentarer som helt tydelig beskriver programmet på engelsk, for å vise at det er det som er normen. De jeg mener er de typ:

fyll inn det og det her

At vi har noenlunde likt format er sikkert superb, men har jeg tilgang til å se noen av Sverre sine oppgaver? Jeg prøvde å se nå, men fikk ikke til (er klar over at jeg er ganske udugelig på å finne ting). Skulle gjerne sett, slik at jeg lettere kan samkjøre "stil".

[vegro90]

For ordens skyld kunne jeg tenke meg kommentarer på engelsk også :) BTW: Alt som vi skriver her blir formatert som Markdown, så # formaterer alt på linjen etter som main header.

Her er sverre sine oppgaver: https://github.com/sloydsalen/KJM1101-exercises/tree/sverre-dev/instructor/source

Du finner de ved å skifte branch når du går til hovedsiden til repoet.

[eirillsh]

hehhe, merket det... Takk! Da skal jeg ta en titt når jeg er ferdig på jobb.