diff --git a/example/README.md b/example/README.md
index 44bc8a9e2c519412a4aca746ca5c71a9d49b36fb..113ac88526addf98475f9bda47dbe5afa41dea91 100644
--- a/example/README.md
+++ b/example/README.md
@@ -1,15 +1,12 @@
 # example
 
-Example box. Not compiled. Keep four lines in same order.
+This is description of the box. It will be copied. Keep it short and single-line. Don't remove the line break before.
 Version: 1.0
 
-This section will be automatically replaced by `python make.py` with auto-generated
-content of Vagrantfile that will refer to this box.
+Write what this box consists of and how it behaves.
+First four lines have a special meaning - dont move them around. Change only version number, not the word.
 
 ---
 
-Usage in Vagrantfile:
-```
-config.vm.box = "henrietta/example"
-config.vm.box_url = "http://dev.dms-serwis.com.pl/vagrant/example.box"
-```
+This section will be automatically replaced by `python make.py` with auto-generated
+content of Vagrantfile that will refer to this box.
diff --git a/make.py b/make.py
index 78ddf262432531b2ccb147588fdb319db2b082b2..09ce094621057e8c1ee2876fddd16a38f7acba94 100644
--- a/make.py
+++ b/make.py
@@ -99,7 +99,7 @@ build_$BOX:
   after_script:
     - vagrant destroy -f
     - cd ..
-'''.replace('$BOX', box).replace('$PREFIX', PREFIX))
+'''.replace('$BOX', box).replace('$PREFIX', PREFIX).replace('\n', os.linesep))
 
         if len(gitlabci) == 0:
             gitlabci = ['''check_validity:
@@ -111,7 +111,7 @@ build_$BOX:
     - grep "1.0" metadata.json
     - grep "test" metadata.json
     - cd ..
-''']
+'''.replace('\n', os.linesep)]
 
         writefile(gitlabci, '.gitlab-ci.yml')
 
@@ -164,7 +164,7 @@ First four lines have a special meaning - dont move them around. Change only ver
 
 This section will be automatically replaced by `python make.py` with auto-generated
 content of Vagrantfile that will refer to this box.
-'''.replace('$BOX', box).replace('$PREFIX', PREFIX), 'README.md', box)
+'''.replace('$BOX', box).replace('$PREFIX', PREFIX).replace('\n', os.linesep), 'README.md', box)
 
             writefile('''#!/bin/bash