diff --git a/README.md b/README.md
index 364ccc9..30d054e 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,19 @@
-# the_smallest_rest_api_testing_framework
+# The smallest REST API testing framework
 
-The Smallest REST API testing framework in just ~~16~~15 lines of code (#code16challenge)
+![Picture of toy excavator with additional logo on the flow](https://testerembyc.pl/images/posts/jeszcze-mniejszy-framework-do-testow-w-pythonie.jpg "Picture from pexels.com")
 
-More information at (PL only): https://testerembyc.pl/posts/20201218/najmniejszy-framework-do-testow-w-pythonie/ 
+The Smallest REST API testing framework in 16 lines of code (#code16challenge)
+
+Full description and road to achieve it is described in those 2 articles (writen in Polish):
+
+* https://testerembyc.pl/posts/20201218/najmniejszy-framework-do-testow-w-pythonie/
+* https://testerembyc.pl/posts/jeszcze-mniejszy-framework-do-testow-w-pythonie/
+
+Branches with most interesting versions of the framework:
+
+* [first article](https://github.com/mkusz/the_smallest_rest_api_testing_framework/tree/first_article) - 15 lines of code with limited functionality
+* [only 6 lines of code](https://github.com/mkusz/the_smallest_rest_api_testing_framework/tree/6_lines) - same 
+  functionality as in **first article**, but in a limited lines of a code
+* [more functionality](https://github.com/mkusz/the_smallest_rest_api_testing_framework/tree/more_functionality) - 
+  code with extended testing abilities but still in 16 lines of code
+* [PEP-8 valid](https://github.com/mkusz/the_smallest_rest_api_testing_framework/tree/pep8_valid) - version that is valid with PEP-8 style coding guide, functionality is somewhere in between versions with **6 lines** of code and **more functionality** but still in 16 lines of code
\ No newline at end of file