Task association of Position test and minor fixes to Windowing system…

… concept exercise (#604)

* Remove type declaration from introduction snippet

The concept of type declaration is introduced later. Also the
declaration is not necessary here for other reasons than type safety.

* Fix markdown syntax of concept introduction

* Specify code block as text in instructions

* Add hint on parameter positioning

* Move / reassign Position property test to task 4

* Apply automatic changes

---------

Co-authored-by: mk-mxp <[email protected]>

concepts/class-basics/introduction.md

@@ -23,7 +23,7 @@ class Door
 
 Classes are instantiated with the `new` keyword, this allocates memory for the class instance and calls the classes constructor method.
 Instantiated classes may be assigned to a variable.
-To invoke the methods of a class instance, we can use the `->` access operator 
+To invoke the methods of a class instance, we can use the `->` access operator.
 
 ```php
 <?php
@@ -49,7 +49,7 @@ class Car
         $this->color = $color;
     }
 
-    function getColor(): string
+    function getColor()
     {
         return $this->color;
     }
@@ -59,5 +59,3 @@ $a_car = new Car("red");
 $a_car->color; // => "red" by accessing the property
 $a_car->getColor(); // => "red" by invoking the instance method
 ```
-
-

exercises/concept/windowing-system/.docs/hints.md

@@ -3,11 +3,12 @@
 ## General
 
 - Revisit the [Objects Concept][concept-class-basics] if needed to fresh up on the basics.
+- Carefully read the instructions for the parameter positioning of `x`, `y`, `width`, and `height`. These are easily confused.
 
 ## 1. Define a ProgramWindow class
 
 - Remember to use [class syntax][php-class] for this task.
-- Define [properties][php-properties] by adding them to class declaration.
+- Define [properties][php-properties] by adding them to the class declaration.
 
 ## 2. Define a constructor function for the ProgramWindow class
 

exercises/concept/windowing-system/.docs/instructions.md

@@ -4,7 +4,7 @@ In this exercise, you will be simulating a windowing based computer system.
 You will create some windows that can be moved and resized.
 The following image is representative of the values you will be working with below.
 
-```
+```text
  ╔════════════════════════════════════════════════════════════╗
  ║                                                            ║
  ║        position::$x,_                                      ║

exercises/concept/windowing-system/.docs/introduction.md

@@ -25,7 +25,7 @@ class Door
 
 Classes are instantiated with the `new` keyword, this allocates memory for the class instance and calls the classes constructor method.
 Instantiated classes may be assigned to a variable.
-To invoke the methods of a class instance, we can use the `->` access operator 
+To invoke the methods of a class instance, we can use the `->` access operator.
 
 ```php
 <?php
@@ -51,7 +51,7 @@ class Car
         $this->color = $color;
     }
 
-    function getColor(): string
+    function getColor()
     {
         return $this->color;
     }

exercises/concept/windowing-system/ProgramWindowTest.php

@@ -74,17 +74,6 @@ public function testHasConstructorSettingInitialValues()
         $this->assertEquals(800, $window->width);
     }
 
-    /**
-     * @testdox assert Position class exists, with constructor, properties
-     * @task_id 3
-     */
-    public function testPositionHasConstructorSettingInitialValues()
-    {
-        $position = new Position(30, 70);
-        $this->assertEquals(30, $position->y);
-        $this->assertEquals(70, $position->x);
-    }
-
     /**
      * @testdox assert Position class exists, with constructor, properties
      * @task_id 3
@@ -109,6 +98,17 @@ public function testProgramWindowResize()
         $this->assertEquals(2135, $window->width);
     }
 
+    /**
+     * @testdox assert Position class exists, with constructor, properties
+     * @task_id 4
+     */
+    public function testPositionHasConstructorSettingInitialValues()
+    {
+        $position = new Position(30, 70);
+        $this->assertEquals(30, $position->y);
+        $this->assertEquals(70, $position->x);
+    }
+
     /**
      * @testdox assert ProgramWindow::move function exists
      * @task_id 4