First version of instructions

Author: Laura Ojala

.gitignore

@@ -1,5 +1,5 @@
-*/output.xml
-*/report.html
-*/log.html
-*/new_file.txt
+output.xml
+report.html
+log.html
+new_file.txt
 .DS_Store

Examples/my_first.robot

@@ -1,6 +1,4 @@
 *** Test Cases ***
 
 My First Robot Test
-    Log To Console            Hello Robot World!
-
- 
+    Log To Console            Hello Robot World!

README.md

@@ -2,7 +2,7 @@
 
 ## Introduction
 
-Hello! So you want to learn Robot Framework? This guide is everything you need for getting started! You don’t need any previous experience in test automation to use this guide. With the guide, you will learn how to install Robot Framework on your system and get started building cool test cases.
+Hello! So you want to learn Robot Framework? This guide is everything you need for getting started! You don’t need any previous experience in test automation to use this guide. You will learn how to install Robot Framework on your computer and get started building cool automation.
 
 ## Installation
 
@@ -11,7 +11,7 @@ Hello! So you want to learn Robot Framework? This guide is everything you need f
 python --version
 ```
 2. If Python is not installed, download and install latest version from [Python Downloads](https://www.python.org/downloads/). If installing to Windows, check "Add Python to PATH" in the Python installer.
-3. Re-start your Terminal/Command Prompt after Python installation
+3. Restart the Terminal/Command Prompt program after Python installation.
 4. Next, install Robot Framework. Type in to Terminal/Command Prompt:
 ```
 pip install robotframework
@@ -37,17 +37,55 @@ and for checking if installation was succesfull:
 py -m robot --version
 ```
 
-## Writing the first automation case
+### Selecting code editor
 
+Simple robot automation can be written using a any text editor, even Notepad. Check list of [suggested editors on Robot Framework's homepage](https://robotframework.org/#tools). If you don't have preference, very popular editor is [Visual Studio Code](https://code.visualstudio.com/), that has really good [Robot Framework extension](https://marketplace.visualstudio.com/items?itemName=TomiTurtiainen.rf-intellisense).
 
-* Selecting editor
-* Naming file
-* Structure of the test/task
-* Running it
-* Checking the log files
+## Writing a first automation case
 
-## More information
+Following example shows how to write your first robot automation case:
 
-Utilizing [libraries](https://robotframework.org/#libraries)
+1. Create a new file and save it using an extension `.robot`, for example, `my_first.robot`
+2. Write in file `*** Test Cases ***`. This creates [section](https://robotframework.org/robotframework/latest/RobotFrameworkUserGuide.html#test-data-sections) for test cases.
+3. Type in following (note to add the four spaces before `Log To Console`)
+```
+My First Robot Test
+    Log To Console            Hello Robot World!
+```
+4. First test is now ready and it should look like this:
+```
+*** Test Cases ***
+
+My First Robot Test
+    Log To Console            Hello Robot World!
+```
+5. Open Terminal/Command Prompt. Navigate to the same folder where your `.robot` file is located and run the test by inputting command `robot my_first.robot`. For example:
+```
+cd your_folder
+robot my_first.robot
+```
+6. When Robot is run, you will see this:
+```
+> robot my_first.robot
+==============================================================================
+My First                                                                      
+==============================================================================
+My First Robot Test                                                   Hello Robot World!
+My First Robot Test                                                   | PASS |
+------------------------------------------------------------------------------
+My First                                                              | PASS |
+1 critical test, 1 passed, 0 failed
+1 test total, 1 passed, 0 failed
+==============================================================================
+Output:  /output.xml
+Log:     /log.html
+Report:  /report.html
+
+``` 
+Robot has created test report files in the same folder where you run the test. You can check details of the first test run by opening report.html file.
+
+[Examples](./Examples) of this manual introduces Keyword Libraries and Variables related to Robot Framework automation.
+
+## More information
 
-References
+Thank you for visiting the Beginners Guide! Hope you enjoyed learning Robot Framework. More about writing test cases: [How To Write Good Test Cases](https://github.com/robotframework/HowToWriteGoodTestCases/blob/master/HowToWriteGoodTestCases.rst).