Merge pull request #70 from php-school/clarify-hello-world-instructions

Clarify hello world instructions

Author: AydinHassan

app/config.php

@@ -16,6 +16,7 @@
 use PhpSchool\LearnYouPhp\Exercise\TimeServer;
 use PhpSchool\LearnYouPhp\Exercise\DependencyHeaven;
 use PhpSchool\LearnYouPhp\TcpSocketFactory;
+use PhpSchool\PhpWorkshop\Event\Event;
 use Symfony\Component\Filesystem\Filesystem;
 use Faker\Factory as FakerFactory;
 
@@ -51,5 +52,15 @@
     }),
     DependencyHeaven::class  => factory(function (ContainerInterface $c) {
         return new DependencyHeaven(FakerFactory::create('fr_FR'));
-    })
+    }),
+
+    'eventListeners' => [
+        'exercise.selected.hello-world' => [
+            function () {
+                if (!file_exists('hello-world.php')) {
+                    touch('hello-world.php');
+                }
+            }
+        ]
+    ]
 ];

composer.json

@@ -14,7 +14,7 @@
     "require" : {
         "php" : ">=5.6",
         "ext-pdo_sqlite": "*",
-        "php-school/php-workshop": "^0.5",
+        "php-school/php-workshop": "^1.2",
         "hoa/socket": "^1.0",
         "php-school/workshop-installer": "^0.1"
     },

composer.lock

@@ -10,14 +10,34 @@ To make a PHP program, create a new file with a `.php` extension and start writi
 $ php program.php
 ```
 
-You can write to the console like so:
+You can write to the console from a PHP program with the following code:
 
 ```php
 <?php
 echo "text";
 ```
 
-When you are done, you must run:
+The first line tells the PHP to interpret the code following it. It is required before any PHP code is written. Read more here: [http://php.net/manual/en/language.basic-syntax.phptags.php]()
+The second line is the instruction to print out some text.
+
+Place the code in to a text file using your favourite text editor, some popular editors are listed below:
+
+* Sublime Text: [https://www.sublimetext.com/]()
+* Atom: [https://atom.io/]()
+
+Switch back to the terminal and run your code again with the same command as above:
+
+```sh
+$ php program.php
+```
+
+You should see the word "text" printed out on the console.
+
+Now you must adapt the code to pass the challenge presented. Remember the challenge was: Write a program that prints the text "Hello World" to the console (stdout).
+
+We have created you a file named `hello-world.php` in your current working directory, feel free to use it!
+
+When you have finished and saved the file you must run the following (substituting program.php to the name of the file you created which contains your code)
 
 ```sh
 $ {appname} verify program.php