Merge branch 'master' of https://github.com/Nurou/programming-20

Author: Nurou

README.md

@@ -1,4 +1,4 @@
-# Ohjelmointi 19
+# Ohjelmointi 20
 
 ## Development environment
 

data/img/drawings/part1.4-variable-change-1.png

@@ -5,24 +5,42 @@ hidden: false
 information_page: true
 ---
 
-## Käyttöliittymätestit
+<!-- ## Käyttöliittymätestit -->
+## User interface tests
 
-Osa käyttöliittymätesteistä odottaa, että NetBeans/tmcbeans saa siirtää hiiren kursoria näytöllä, esimerkiksi testatakseen tehtävässä tehdyn käyttöliittymän nappuloita. macOS ei oletuksena salli turvasyistä ohjelmia siirtämään hiirtä, joten tmcbeans:lle pitää käydä lisäämässä oikeus tätä varten.
+<!-- Osa käyttöliittymätesteistä odottaa, että NetBeans/tmcbeans saa siirtää hiiren kursoria näytöllä, esimerkiksi testatakseen tehtävässä tehdyn käyttöliittymän nappuloita. macOS ei oletuksena salli turvasyistä ohjelmia siirtämään hiirtä, joten tmcbeans:lle pitää käydä lisäämässä oikeus tätä varten. -->
+Some of the user interface tests expect that Netbeans/tmcbeans is allowed to move the mouse cursor on the screen. For example to test the buttons in the UI that are created in the exercise. MacOS does not allow this because of the security concerns. This is why tmcbeans has to be given the permission manually.
 
-Oikeuden voi lisätä seuraavasti:
 
-1. Avaa ensin System Preferences. Voit avata sen esimerkiksi hakemalla Spotlight:sta (suurennuslasikuvake oikeassa yläkulmassa) system preferences, ja avaamalla sieltä System Preferences.app.
+
+<!-- Oikeuden voi lisätä seuraavasti: -->
+The permission can be added as follows:
+
+<!-- 1. Avaa ensin System Preferences. Voit avata sen esimerkiksi hakemalla Spotlight:sta (suurennuslasikuvake oikeassa yläkulmassa) system preferences, ja avaamalla sieltä System Preferences.app. -->
+1. Open the `System Preferences`. You can open it from example by searching from Spotlight (magnifying glass on the upper right corner) by keyword _System Preferences_ and by opening the `System Preferences.app`.
+
 ![spotlight haku](./img/macos-guide/search_system_preferences.png)
-2. Paina avautuvassa näkymässä yläriviltä löytyvää Security & Privacy.
-![system preferences näkymä](./img/macos-guide/system_preferences.png)
-3. Navigoi näkymässä Privacy-välilehdelle ja siellä Accessibility -osioon.
-![privacy-->accessibility näkymä](./img/macos-guide/navigation.png)
-4. Paina vasemmasta alakulmasta "Click the lock to make changes." Username-kentässä pitäisi lukea automaattisesti tietokoneesi käyttäjätunnus. Syötä se, jos se puuttuu. Syötä salasanasi Password-kenttään ja paina Unlock.
-![salasanansyöttämisnäkymä](./img/macos-guide/open-lock.png)
-7. Paina nyt plus-kuvaketta. Navigoi avautuvassa näkymässä siihen kansioon, mihin tmcbeans on asennettuna koneellasi. Valitse tmcbeans.app ja paina Open.
-![Finder-hakemisto, jossa navigoitu tmcbeansiin](./img/macos-guide/add_tmcbeans.png)
-![accessibility-näkymä, johon on lisätty tmcbeans](./img/macos-guide/tmcbeans_added.png)
-9. Paina vasemmasta alakulmasta "Click the lock to prevent further changes."
-![accessibility-näkymä, johon ei voi tehdä enää muutoksia](./img/macos-guide/done.png)
-
-Nyt tmcbeans pitäisi pystyä siirtämään hiirtä testien ajossa. Huomaathan, että et saa samanaikaisesti siirtää itse hiirtä tai availla ikkunoita, kun testit pyörivät. Testien pitää saada rauhassa navigoida yksin näytöllä, jotta ne testaavat oikein ohjelmasi toimintaa.
+
+<!-- 2. Paina avautuvassa näkymässä yläriviltä löytyvää Security & Privacy.
+![system preferences näkymä](./img/macos-guide/system_preferences.png) -->
+2. Press the `Security & Privacy` from the opened menu.
+
+<!-- 3. Navigoi näkymässä Privacy-välilehdelle ja siellä Accessibility -osioon.
+![privacy2accessibility näkymä](./img/macos-guide/navigation.png) -->
+3. From there navigate to `Privacy` tab and from there to `Accessability section`.
+
+<!-- 4. Paina vasemmasta alakulmasta "Click the lock to make changes." Username-kentässä pitäisi lukea automaattisesti tietokoneesi käyttäjätunnus. Syötä se, jos se puuttuu. Syötä salasanasi Password-kenttään ja paina Unlock.
+![salasanansyöttämisnäkymä](./img/macos-guide/open-lock.png) -->
+4. Press from the lower left corner "Click the lock to make changes.". In the username field there should be the name of your computer. Write if it's not there. Give your password in the password field and click Unlock.
+
+<!-- 7. Paina nyt plus-kuvaketta. Navigoi avautuvassa näkymässä siihen kansioon, mihin tmcbeans on asennettuna koneellasi. Valitse tmcbeans.app ja paina Open. -->
+7. Click the plus-icon. Navigate to the folder where your tmcbeans is installed. Select tmcbeans.app and click Open.
+![Finder navigated to the tmcbeans](./img/macos-guide/add_tmcbeans.png)
+![accessibility-view with tmcbeans added](./img/macos-guide/tmcbeans_added.png)
+
+<!-- 9. Paina vasemmasta alakulmasta "Click the lock to prevent further changes." -->
+9. In the lower left corner, click "Click the lock to prevent further changes."
+![accessibility-view, that doesn't allow more modifications](./img/macos-guide/done.png)
+
+<!-- Nyt tmcbeans pitäisi pystyä siirtämään hiirtä testien ajossa. Huomaathan, että et saa samanaikaisesti siirtää itse hiirtä tai availla ikkunoita, kun testit pyörivät. Testien pitää saada rauhassa navigoida yksin näytöllä, jotta ne testaavat oikein ohjelmasi toimintaa. -->
+Now your tmcbeans should be able to move your mouse cursor during the execution of tests. Note that you may not be allowed to move your cursor or open windows during the tests. Tests should be allowed to run without interference in order for them to work correctly.

data/img/drawings/part1.4-variable-change-2.png

@@ -15,7 +15,7 @@ hidden: false
 </text-box>
 
 
-<quiznator id="5c12b7f263de8e5db0cf8b8e"></quiznator>
+<quiz id="3799f901-ef2a-53da-b4c6-669fbbf0038a"></quiz>
 
 TODO aloituskysely englanniksi
 
@@ -152,4 +152,4 @@ In order to work Java-programs require a code boilerplate, which will become fam
 <!-- Alla on kurssin ensimmäinen kyselytehtävä. Kyselytehtäviin vastataan suoraan kurssimateriaalissa. -->
 Below is the first quizz of the course. Quizzes can be answered straight in the course material.
 
-<quiznator id="5c136a4ea50dbe1223d1981d"></quiznator>
+<quiz id="118e6b38-0d42-5667-a674-84ae174ad798"></quiz>

data/img/drawings/part1.4-variable-change-3.png

@@ -389,7 +389,7 @@ Writing the command `System.out.println("...") can be pretty cumbersome. In NetB
 
 Animation below illustrates the use of sout-command. First user writes sout and then pressed tabulator. A Magic Trick!
 
-![](../img/sout.gif)
+![](../img/part1.2-sout.gif)
 
 </text-box>
 

data/img/drawings/part1.4-variable-change-4.png

@@ -606,7 +606,7 @@ I will tell you a story, but I need some information first.
 What is the main character called?
 **Bob**
 What is their job?
-**builder**
+**a builder**
 Here is the story:
 Once upon a time there was Bob, who was a builder.
 On the way to work, Bob reflected on life.
@@ -638,7 +638,7 @@ I will tell you a story, but I need some information first.
 What is the main character called?
 **Ada**
 What is their job?
-**Data scientist**
+**a Data scientist**
 Here is the story:
 Once upon a time there was Ada, who was a Data scientist.
 On the way to work, Ada reflected on life.

data/img/drawings/part1.6-boolean-variable.png

@@ -242,25 +242,25 @@ The value of the variable is 42
 
 Let's look at the preceding program's execution step-by-step. When a variable appears in the program for the first time, i.e., the computer is told both its type (here `int`) and its name (here `value`), the computer creates a 'named container' for the variable. Then, the value on the right side of the equals sign is copied into this named container.
 
-![](../img/drawings/muuttujan-arvon-vaihto-1.png)
+![](../img/drawings/part1.4-variable-change-1.png)
 
 <!-- Kun ohjelmakoodissa viitataan muuttujaan sen nimellä -- tässä halutaan tulostaa merkkijono "Muuttujan arvo on " sekä muuttujan `luku` arvo, muuttujan `luku` arvo haetaan sen nimellä löytyvästä lokerosta. -->
 
 Whenever a variable is referenced by its name in a program -- here, we want to print the string "The value of the variable is " followed by the value of the `value` variable -- its value is retrieved from a container that has its name.
 
-![](../img/drawings/muuttujan-arvon-vaihto-2.png)
+![](../img/drawings/part1.4-variable-change-2.png)
 
 <!-- Kun muuttujaan asetetaan arvo (tässä `luku = 42`), tarkistetaan ensin löytyykö muuttujan nimistä lokeroa. Jos lokero löytyy, uusi arvo kopioidaan lokeroon vanhan arvon tilalle ja vanha arvo katoaa. Jos muuttujan nimellä ei löydy lokeroa, ohjelman suoritus päättyy virheilmoitukseen tai ohjelmaa ei voida käynnistää. -->
 
 Whenever a value is assigned to a variable (here `value = 42`), a check is run to see whether a container with the given name already exists. If one does, a new value is copied in the place of the old value, and the old value disappears. If a container of the variable name is not found, the program execution ends in an error message, or it fails to run.
 
-![](../img/drawings/muuttujan-arvon-vaihto-3.png)
+![](../img/drawings/part1.4-variable-change-3.png)
 
 <!-- Seuraavaksi ohjelmakoodissa viitataan taas muuttujaan sen nimellä -- tässäkin halutaan tulostaa merkkijono "Muuttujan arvo on " sekä muuttujan `luku` arvo. Toimitaan kuten normaalisti, eli haetaan muuttujan `luku` arvo sen nimellä löytyvästä lokerosta. -->
 
 The variable is then referenced again by its name in the program -- we again want to print the string "The value of the variable is " followed by the value of the `value` variable. We proceed as normal, retrieving the value of `value` from a container having its name.
 
-![](../img/drawings/muuttujan-arvon-vaihto-4.png)
+![](../img/drawings/part1.4-variable-change-4.png)
 
 <!-- Kuten huomaat, ohjelman lopputilanteessa muuttujan alkuperäinen arvo on kadonnut. Muuttuja voi sisältää kerrallaan aina vain yhden arvon. -->
 

data/img/part1.2-sout.gif

@@ -176,7 +176,7 @@ How many days would you like to convert to seconds?
 </programming-exercise>
 
 
-<quiznator id="5c12b7f263de8e5db0cf8b8f"></quiznator>
+<quiz id="54056702-b227-5747-8d6c-d3f15e8f5c8a"></quiz>
 
 
 <text-box variant='hint' name='Expression and Statement'>
@@ -245,7 +245,7 @@ int second = 4;
 first + second;
 ```
 
-<quiznator id="5c12b7f263de8e5db0cf8b90"></quiznator>
+<quiz id="f9af4add-d06f-59bb-ab42-d1cb9733ba88"></quiz>
 
 
 <!-- ## Laskentaa ja tulostamista -->
@@ -938,7 +938,7 @@ The average is 4.333333333333333
 </programming-exercise>
 
 
-<quiznator id="5c12b7f263de8e5db0cf8b91"></quiznator>
+<quiz id="cff67523-26f0-5f35-b00f-070778b40541"></quiz>
 
 
 <!-- <programming-exercise name="Nelilaskin" tmcname='osa01-Osa01_23.Nelilaskin'> -->
@@ -1135,4 +1135,4 @@ You'll find a step-by-step visualization of the previous program below, which go
 
 <code-states-visualizer input='{"code":"public class CalculationInSteps {\n  public static void main(String[] args) {\n    int first = (1 + 1);\n    int second = first + 3 * (2 + 5);\n\n    first = 5;\n\n    int third = first + second;\n    System.out.println(first);\n    System.out.println(second);\n    System.out.println(third);\n  }\n}","stdin":"","trace":[{"stdout":"","event":"call","line":3,"stack_to_render":[{"func_name":"main:3","encoded_locals":{},"ordered_varnames":[],"parent_frame_id_list":[],"is_highlighted":true,"is_zombie":false,"is_parent":false,"unique_hash":"1","frame_id":1}],"globals":{},"ordered_globals":[],"func_name":"main","heap":{}},{"stdout":"","event":"step_line","line":3,"stack_to_render":[{"func_name":"main:3","encoded_locals":{},"ordered_varnames":[],"parent_frame_id_list":[],"is_highlighted":true,"is_zombie":false,"is_parent":false,"unique_hash":"2","frame_id":2}],"globals":{},"ordered_globals":[],"func_name":"main","heap":{}},{"stdout":"","event":"step_line","line":4,"stack_to_render":[{"func_name":"main:4","encoded_locals":{"first":2},"ordered_varnames":["first"],"parent_frame_id_list":[],"is_highlighted":true,"is_zombie":false,"is_parent":false,"unique_hash":"4","frame_id":4}],"globals":{},"ordered_globals":[],"func_name":"main","heap":{}},{"stdout":"","event":"step_line","line":6,"stack_to_render":[{"func_name":"main:6","encoded_locals":{"first":2,"second":23},"ordered_varnames":["first","second"],"parent_frame_id_list":[],"is_highlighted":true,"is_zombie":false,"is_parent":false,"unique_hash":"9","frame_id":9}],"globals":{},"ordered_globals":[],"func_name":"main","heap":{}},{"stdout":"","event":"step_line","line":8,"stack_to_render":[{"func_name":"main:8","encoded_locals":{"first":5,"second":23},"ordered_varnames":["first","second"],"parent_frame_id_list":[],"is_highlighted":true,"is_zombie":false,"is_parent":false,"unique_hash":"12","frame_id":12}],"globals":{},"ordered_globals":[],"func_name":"main","heap":{}},{"stdout":"","event":"step_line","line":9,"stack_to_render":[{"func_name":"main:9","encoded_locals":{"first":5,"second":23,"third":28},"ordered_varnames":["first","second","third"],"parent_frame_id_list":[],"is_highlighted":true,"is_zombie":false,"is_parent":false,"unique_hash":"17","frame_id":17}],"globals":{},"ordered_globals":[],"func_name":"main","heap":{}},{"stdout":"5\n","event":"step_line","line":10,"stack_to_render":[{"func_name":"main:10","encoded_locals":{"first":5,"second":23,"third":28},"ordered_varnames":["first","second","third"],"parent_frame_id_list":[],"is_highlighted":true,"is_zombie":false,"is_parent":false,"unique_hash":"21","frame_id":21}],"globals":{},"ordered_globals":[],"func_name":"main","heap":{}},{"stdout":"5\n23\n","event":"step_line","line":11,"stack_to_render":[{"func_name":"main:11","encoded_locals":{"first":5,"second":23,"third":28},"ordered_varnames":["first","second","third"],"parent_frame_id_list":[],"is_highlighted":true,"is_zombie":false,"is_parent":false,"unique_hash":"24","frame_id":24}],"globals":{},"ordered_globals":[],"func_name":"main","heap":{}},{"stdout":"5\n23\n28\n","event":"step_line","line":12,"stack_to_render":[{"func_name":"main:12","encoded_locals":{"first":5,"second":23,"third":28},"ordered_varnames":["first","second","third"],"parent_frame_id_list":[],"is_highlighted":true,"is_zombie":false,"is_parent":false,"unique_hash":"27","frame_id":27}],"globals":{},"ordered_globals":[],"func_name":"main","heap":{}},{"stdout":"5\n23\n28\n","event":"return","line":12,"stack_to_render":[{"func_name":"main:12","encoded_locals":{"first":5,"second":23,"third":28,"__return__":["VOID"]},"ordered_varnames":["first","second","third","__return__"],"parent_frame_id_list":[],"is_highlighted":true,"is_zombie":false,"is_parent":false,"unique_hash":"28","frame_id":28}],"globals":{},"ordered_globals":[],"func_name":"main","heap":{}}],"userlog":"Debugger VM maxMemory: 455M\n"}'></code-states-visualizer>
 
-<quiznator id="5c12b7f263de8e5db0cf8b92"></quiznator>
+<quiz id="286b44eb-0a4f-51de-9c67-68d5351a3b37"></quiz>