diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 62eaa377128..5ad47781256 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -46,9 +46,9 @@ between threads are allowed.
 
  Download Kotlin N redistributable and unpack it. You can run command line compiler with
 
-	./dist/bin/kotlinc <some_file>.kt <dir_with_kt_files> -o <executable>.kexe
+	bin/kotlinc <some_file>.kt <dir_with_kt_files> -o <executable>.kexe
 
-  During the first run it will download all external dependencies such as LLVM.
+  During the first run it will download all the external dependencies, such as LLVM.
 
   One may use `'-h'` flag to `kotlinc` to see available flags.
 
@@ -81,4 +81,4 @@ Notice that property delegation (including lazy properties) *does* work.
 
    Due to significant difference in exception handling model on MS Windows and
  other LLVM targets, current _Kotlin N_ may not produce executables working on
- MS Windows. This situation could be improved in upcoming releases.
\ No newline at end of file
+ MS Windows. This situation could be improved in upcoming releases.
diff --git a/samples/opengl/README.md b/samples/opengl/README.md
new file mode 100644
index 00000000000..9a682854a00
--- /dev/null
+++ b/samples/opengl/README.md
@@ -0,0 +1,12 @@
+# OpenGL application
+
+ This example shows interaction with OpenGL library, to render classical 3D test model.
+
+To build use `./build.sh` script without arguments (or specify `TARGET` variable if cross-compiling).
+
+To run use
+
+    ./OpenGlTeapot.kexe
+
+It will render 3D model of teapot. Feel free to experiment with it, the whole power of OpenGL
+is at your hands.
diff --git a/samples/socket/README.md b/samples/socket/README.md
new file mode 100644
index 00000000000..1fd7216cb9d
--- /dev/null
+++ b/samples/socket/README.md
@@ -0,0 +1,18 @@
+# Sockets demo
+
+Compile the echo server (in EAP only supported on Mac host):
+
+    ./build.sh
+
+Run the server:
+
+    ./EchoServer.kexe 3000 &
+
+Test the server by conecting to it, for example with telnet:
+
+    telnet localhost 3000
+
+Write something to console and watch server echoing it back.
+
+~~Quit telnet by pressing ctrl+] ctrl+D~~
+
diff --git a/samples/tetris/README.md b/samples/tetris/README.md
index f91bb1be017..7420ae14daa 100644
--- a/samples/tetris/README.md
+++ b/samples/tetris/README.md
@@ -1,4 +1,4 @@
-   #Tetris game
+# Tetris game
 
 This example shows implementation of simple Tetris game using SDL
 (Simple DirectMedia Layer) library for rendering. SDL allows easy development