Publish part 11

nygrenh · nygrenh · commit b1d03a459c36 · 2020-04-08T02:23:09.000+03:00
diff --git a/course-settings.js b/course-settings.js
@@ -28,7 +28,6 @@ const courseSettings = {
     { separator: true, title: "Java Programming I" },
   ],
   sidebarFuturePages: [
-    { title: "Part 11", tba: "7.4." },
     { title: "Part 12", tba: "21.4." },
     { title: "Part 13", tba: "28.4." },
     { title: "Part 14", tba: "5.5." },
diff --git a/data/part-11/1-class-diagrams.md b/data/part-11/1-class-diagrams.md
@@ -1,7 +1,7 @@
 ---
 path: '/part-11/1-class-diagrams'
 title: 'Class diagrams'
-hidden: true
+hidden: false
 ---
 
 
@@ -110,7 +110,7 @@ We also write the return type of a method to the class diagram.
 <img src="../img/diagrams/part4.1-classdiagram-person-name-age-constructor-print.png" alt="[Person|-name:String;-age:int|+Person(initialName:String);+printPerson():void]">
 
 
-<text-box variant='hint' name='Luokkakaavio kertoo luokat, muuttujat, konstruktorit, ja metodit'>
+<text-box variant='hint' name='A class diagram describes classes, construcutors and methods'>
 
 <!-- Luokkakaaviossa kuvataan luokat, muuttujat, konstruktorit, ja metodit sekä luokkien väliset yhteydet. Luokkakaavio ei kuitenkaan kerro mitään konstruktorien ja metodien sisäisestä toteutuksesta. Luokkakaaviolla kerrotaan siis olioiden rakenteesta, mutta luokkakaaviot eivät itsessään määrittele toiminnallisuutta. -->
 A class diagram describes classes and their attributes, constructors and methods as well as the connections between classes. However a class diagram tells us nothing about the implementation of the constructors or the methods. Therefore a class diagram describes the structure of an object but not its functionality.
@@ -383,7 +383,7 @@ Inheritance of abstract classes is described almost the same way as regular clas
 <img src="../img/diagrams/part11.1-classdiagram-abstracts.png" />
 
 
-<programming-exercise name='Player and bot' nocoins='true' tmcname='part11-Part11_05.PlayerAndBot'>
+<programming-exercise name='The Player And the Bot' nocoins='true' tmcname='part11-Part11_05.ThePlayerAndTheBot'>
 
 <!-- Alla on kuvattu kaksi luokkaa, Pelaaja ja Tekoaly, sekä niiden välinen yhteys. Toteuta kuvatut luokat tehtäväpohjaan. -->
 
@@ -439,7 +439,7 @@ Below you'll see the interface Saveable and the class Person. Implement the cont
 </programming-exercise>
 
 
-<text-box variant='hint' name='Miten näitä kannattaa piirtää?'>
+<text-box variant='hint' name='How these should be drawn?'>
 
 <!-- Luokkakaaviot ovat erinomainen tapa kuvata ongelma-aluetta ja ongelman muotoa muille. Niiden käyttö on erittäin hyödyllistä myös silloin, kun ohjelmoija suunnittelee useammasta luokasta koostuvan ohjelman rakennetta. -->
 Class diagrams are an excellent way to describe a problem and a problem-domain to others. They are particularily useful when a programmer is designing a program with multiple classes.
@@ -451,8 +451,9 @@ Class diagram should also be drawn in a suitable level of abstraction. For examp
 
 
 <!-- Materiaalissa käytetyt luokkakaaviot on piirretty <a href="https://yuml.me/" target="_blank" norel>yUML</a>:n, <a href="https://creately.com" target="_blank" norel>Creately</a>n, ja <a href="https://www.draw.io/" target="_blank" norel>draw.io</a>:n. Myös NetBeansiin löytyy välineitä luokkakaavioiden luomiseen -- esimerkiksi <a href="http://plugins.netbeans.org/plugin/55435/easyuml" target="_blank" norel>easyUML</a> mahdollistaa luokkakaavioiden luomisen suoraan projektin koodista. -->
-The class diagrams in the material have been drawn using <a href="https://yuml.me/" target="_blank" norel>yUML</a>, <a href="https://creately.com" target="_blank" norel>Creately</a>, and <a href="https://www.draw.io/" target="_blank" norel>draw.io</a>.
-NetBeans also has tools for drawing class diagrams -- for example the <a href="http://plugins.netbeans.org/plugin/55435/easyuml" target="_blank" norel>easyUML</a> draws class diagrams from the source code.
+
+<p>The class diagrams in the material have been drawn using <a href="https://yuml.me/" target="_blank" norel>yUML</a>, <a href="https://creately.com" target="_blank" norel>Creately</a>, and <a href="https://www.draw.io/" target="_blank" norel>draw.io</a>.
+NetBeans also has tools for drawing class diagrams -- for example the <a href="http://plugins.netbeans.org/plugin/55435/easyuml" target="_blank" norel>easyUML</a> draws class diagrams from the source code.</p>
 
 </text-box>
 
diff --git a/data/part-11/2-packages.md b/data/part-11/2-packages.md
@@ -1,7 +1,7 @@
 ---
 path: '/part-11/2-packages'
 title: 'Packages'
-hidden: true
+hidden: false
 ---
 
 
@@ -267,9 +267,7 @@ Within the exercise base, create three packages: `a`, `b`, and `c`. Create class
 
 <!-- Kaikki NetBeansissa näkyvät projektit ovat tietokoneesi <a href="http://fi.wikipedia.org/wiki/Tiedostoj%C3%A4rjestelm%C3%A4" target="_blank">tiedostojärjestelmässä</a> tai jollain keskitetyllä levypalvelimella. Jokaiselle projektille on olemassa oma hakemisto, jonka sisällä on projektiin liittyvät tiedostot ja hakemistot. -->
 
-Every project you see in NetBeans are in your computer's <a href="https://en.wikipedia.org/wiki/File_system" target="_blank">file system</a> or on some centralized server.
-
-<br/>
+<p>Every project you see in NetBeans are in your computer's <a href="https://en.wikipedia.org/wiki/File_system" target="_blank">file system</a> or on some centralized server.</p>
 
 <!-- Projektin hakemistossa `src/main/java` on ohjelmaan liittyvät lähdekoodit. Jos luokan pakkauksena on kirjasto, sijaitsee luokka projektin lähdekoodihakemiston `src/main/java/kirjasto`-kansiossa. NetBeansissa voi käydä katsomassa projektien konkreettista rakennetta **Files**-välilehdeltä joka on normaalisti **Projects**-välilehden vieressä. Jos et näe välilehteä **Files**, saa sen näkyville valitsemalla vaihtoehdon **Files** valikosta **Window**. -->
 
@@ -1248,9 +1246,7 @@ In this exercise you will implement the application that was described above. Yo
 
 <!-- Lentokenttä-tehtävässä toteutetaan lentokentän hallintasovellus. Lentokentän hallintasovelluksessa hallinnoidaan lentokoneita ja lentoja. Lentokoneista tiedetään aina tunnus ja kapasiteetti. Lennoista tiedetään lennon lentokone, lähtöpaikan tunnus (esim. <a href="http://en.wikipedia.org/wiki/Helsinki_Airport" target="_blank" rel="noopener">HEL</a>) ja kohdepaikan tunnus (esim. <a href="http://en.wikipedia.org/wiki/Batman_Airport" target="_blank" rel="noopener">BAL</a>). -->
 
-In this exercise you will implement a flight control application. It is used to control the airplanes and their flight routes. The system always knows the identifier and the capacity of an airplance. The flight information consists of the used airplane, the departure airport id (e.g. <a href="http://en.wikipedia.org/wiki/Helsinki_Airport" target="_blank" rel="noopener">HEL</a>), and the destination airport ID (e.g. <a href="http://en.wikipedia.org/wiki/Batman_Airport" target="_blank" rel="noopener">BAL</a>).
-
-<br/>
+<p>In this exercise you will implement a flight control application. It is used to control the airplanes and their flight routes. The system always knows the identifier and the capacity of an airplance. The flight information consists of the used airplane, the departure airport id (e.g. <a href="http://en.wikipedia.org/wiki/Helsinki_Airport" target="_blank" rel="noopener">HEL</a>), and the destination airport ID (e.g. <a href="http://en.wikipedia.org/wiki/Batman_Airport" target="_blank" rel="noopener">BAL</a>).</p>
 
 <!-- Sekä lentokoneita että lentoja voi olla useita. Samalla lentokoneella voidaan myös lentää useita eri lentoja. -->
 
diff --git a/data/part-11/3-exceptions.md b/data/part-11/3-exceptions.md
@@ -1,7 +1,7 @@
 ---
 path: '/part-11/3-exceptions'
 title: 'Exceptions'
-hidden: true
+hidden: false
 ---
 
 
@@ -369,7 +369,7 @@ The methods of the `Calculator` class should be follow in the following manner:
 </programming-exercise>
 
 
-<text-box variant='hint' name='Poikkeusten tyypit'>
+<text-box variant='hint' name='Types of exceptions'>
 
 <!-- Edellä todettiin seuraavaa: *...poikkeuksia on karkeasti ottaen kahdenlaisia. On poikkeuksia jotka on pakko käsitellä, ja on poikkeuksia joita ei ole pakko käsitellä.*. -->
 We said *...there are roughly two categories of exceptions. Exceptions which must be handled, and exceptions which do not have to be handled.*.
diff --git a/data/part-11/4-processing-files.md b/data/part-11/4-processing-files.md
@@ -1,7 +1,7 @@
 ---
 path: '/part-11/4-processing-files'
 title: 'Processing files'
-hidden: true
+hidden: false
 ---
 
 
diff --git a/data/part-11/5-conclusion.md b/data/part-11/5-conclusion.md
@@ -1,11 +1,13 @@
 ---
 path: '/part-11/5-conclusion'
 title: 'Conclusion'
-hidden: true
+hidden: false
 ---
 
-<!-- TODO: puhutaan ohjelmakoodin kommunikoinnin tärkeydestä; kerrotaan siitä että yhteinen kuvauskieli auttaa tässä; todetaan, että kaaviot mahdollistavat kommunikoinnin, ilman että tarvitsee katsoa kooditasoa -- todetaan, että ohjelmia voi katsoa hyvin erilaisista näkövinkkeleistä; koodi on yksi, kaaviot on toinen, mutta on muitakin. -->
+<!-- Ohjelmistojen kehittäjät kommunikoivat toistensa kanssa monilla tavoilla. Ehkäpä tärkein kommunikointitapa on jokapäiväinen keskustelua, piirtämistä, ja ideointia sisältävä vuorovaikutus. Ohjelmistokehittäjät kommunikoivat myös tuotostensa kautta. Ohjelman lähdekoodi kommunikoi ohjelman tarkoituksen, ainakin silloin kun se on kirjoitettu ymmärrettävällä tavalla. Korkeamman abstraktiotason kommunikoinnissa käytetään erilaisia kaavioita, joista luokkakaaviot ovat eräs paljon käytetty kaaviotyyppi. Luokkakaaviot tarjoavat korkean tason kuvan ohjelman rakenteesta. Tässä osassa tutustuit luokkakaavioihin.
 
-Please fill out the survey below!
+Harjoittelit lisäksi poikkeustilanteisiin varautumista. Poikkeustilanteet ovat tilanteita, joissa ohjelman suoritus on päätynyt tilaan, missä sen ei pitäisi olla. Tällaiseen tulee varautua, koska ohjelma voi muuten kaatua. Kertasit myös tiedostojen lukemista ja tutustuit tiedostoihin kirjoittamiseen. Tiedostot säilyvät tietokoneen pysyväismuistissa, josta ne on löydettävissä myös vaikka tietokone sammuisi välillä. Vaikka käytämme erilaisia ohjelmistoja, jotka piilottavat tiedostojen käsittelyn, ovat tiedostot — sekä niiden lukeminen että niihin kirjoittaminen — krittinen osa tietoa käsitteleviä digitaalisia järjestelmiä. -->
 
-<quiz id="f3f3b8b9-4725-5c89-9c52-a6e1ae289d81"></quiz>
+Finally, please take a moment to answer a self-reflective survey on the learning goals of the eleventh part.
+
+<quiz id="ae09e3d8-8a97-4937-8837-e60ff43296bd"></quiz>
diff --git a/data/part-11/index.md b/data/part-11/index.md
@@ -2,20 +2,18 @@
 path: '/part-11'
 title: 'Part 11'
 overview: true
-hidden: true
+hidden: false
 ---
 
 <!-- Kurssimateriaalin yhdennessätoista osassa opit tulkitsemaan yksinkertaisia luokkakaavioita. Tutustut Javan pakkauksiin ja opit mistä `import`-lauseen osat muodostuvat. Harjoittelet Javan poikkeusten käyttöä ja opit sekä niiden käsittelyn että niiden eteenpäin heittämisen. Kertaat tiedon lukemista tiedostosta ja opit kirjoittamaan tietoa tiedostoon. -->
 
 In the eleventh part you'll learn to decypher simple class diagrams. You'll become familiar with packages in Java and learn what the different parts of an `import` statement mean. You'll practise using exceptions in Java: how to throw and handle them. You'll take another look at reading data from a file, and learn to write data to a file.
 
-Only the exercises for this part are currently available in English!
-
 
 <please-login></please-login>
 
 <pages-in-this-section></pages-in-this-section>
 
-Yllä oleva sisällysluettelo sisältää kurssin yhdennentoista osan aihealueet. Kukin kurssin osa on suunniteltu siten, että siinä on työtä yhden viikon ajaksi. Kuhunkin kurssin osaan on hyvä varata reilusti yli kymmenen tuntia aikaa, riippuen aiemmasta tietokoneen käyttökokemuksesta. Ohjelmointia aiemmin kokeilleet saattavat edetä materiaalissa aluksi nopeamminkin.
+The table of contents above lists the topics of the eleventh part of the course. The eleventh part has been designed to cover the eleventh week of the course. You should reserve well above 10 hours for each part of the course, depending on previous experience with computers. If you've tried programming before, you might advance faster in the beginning.
 
 <exercises-in-this-section></exercises-in-this-section>
