diff --git a/README.md b/README.md
index 397fc2c..353d899 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,7 @@
 <p align="center"><img src="assets/logos/128x128.png">
  <h1 align="center">Stargate</h1>
   <p align="center">
-    What is this thing? “the motto” and the goals. The vision.
+    Stargate is a library supporting the creation of HTTP based RESTful APIs.
     <br>
     <a href="docs/"><strong>Explore the docs »</strong></a>
     <br>
@@ -16,7 +16,7 @@
 [![Build Status](https://travis-ci.org/ba-st/Stargate.svg?branch=master)](https://travis-ci.org/ba-st/Stargate)
 [![Coverage Status](https://coveralls.io/repos/github/ba-st/Stargate/badge.svg?branch=master)](https://coveralls.io/github/ba-st/Stargate?branch=master)
 
-Why would I care about this thing? When to use, for whom is designed, when not to use.
+It's built on top of Teapot and Zinc, providing a conceptual framework to simplify the creation of RESTful APIs including HATEOAS, content negotiation, API versioning, ETags and pagination.
 
 ## License
 - The code is licensed under [MIT](LICENSE).
@@ -35,3 +35,6 @@ To load the project in a Pharo image, or declare it as a dependency of your own
 ## Contributing
 
 Check the [Contribution Guidelines](CONTRIBUTING.md)
+
+---
+*Icons by [icons8.com](https://icons8.com)*
diff --git a/assets/logos/128x128.png b/assets/logos/128x128.png
new file mode 100644
index 0000000..88c7fef
Binary files /dev/null and b/assets/logos/128x128.png differ
diff --git a/assets/logos/16x16.png b/assets/logos/16x16.png
new file mode 100644
index 0000000..020f62a
Binary files /dev/null and b/assets/logos/16x16.png differ
diff --git a/assets/logos/256x256.png b/assets/logos/256x256.png
new file mode 100644
index 0000000..aacd9bc
Binary files /dev/null and b/assets/logos/256x256.png differ
diff --git a/assets/logos/32x32.png b/assets/logos/32x32.png
new file mode 100644
index 0000000..126d132
Binary files /dev/null and b/assets/logos/32x32.png differ
diff --git a/assets/logos/512x512.png b/assets/logos/512x512.png
new file mode 100644
index 0000000..f8db337
Binary files /dev/null and b/assets/logos/512x512.png differ
diff --git a/assets/logos/64x64.png b/assets/logos/64x64.png
new file mode 100644
index 0000000..c94bdc0
Binary files /dev/null and b/assets/logos/64x64.png differ
diff --git a/assets/logos/logo.svg b/assets/logos/logo.svg
new file mode 100644
index 0000000..a231513
--- /dev/null
+++ b/assets/logos/logo.svg
@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" x="0px" y="0px"
+     width="50" height="50"
+     viewBox="0 0 252 252"
+     style="fill:#000000;"><g transform=""><g fill="none" fill-rule="nonzero" stroke="none" stroke-width="1" stroke-linecap="butt" stroke-linejoin="miter" stroke-miterlimit="10" stroke-dasharray="" stroke-dashoffset="0" font-family="none" font-weight="none" font-size="none" text-anchor="none" style="mix-blend-mode: normal"><path d="M0,252v-252h252v252z" fill="none"></path><g><g id="surface1"><path d="M232.3125,122.0625c0,60.89282 -49.35718,110.25 -110.25,110.25c-60.89282,0 -110.25,-49.35718 -110.25,-110.25c0,-60.89282 49.35718,-110.25 110.25,-110.25c60.89282,0 110.25,49.35718 110.25,110.25z" fill="#a8b7d1"></path><path d="M208.6875,122.0625c0,47.83447 -38.79053,86.625 -86.625,86.625c-47.83447,0 -86.625,-38.79053 -86.625,-86.625c0,-47.83447 38.79053,-86.625 86.625,-86.625c8.18262,0 16.10376,1.13819 23.625,3.26074c1.33814,0.3999 2.64551,0.7998 3.9375,1.23047c6.33691,2.12256 12.36621,4.92188 17.9187,8.38257c1.13819,0.70752 2.24561,1.41504 3.30689,2.19946c22.84058,15.59619 37.83691,41.82056 37.83691,71.55176z" fill="#becde8"></path><path d="M145.6875,122.0625c0,13.04297 -10.58203,23.625 -23.625,23.625c-13.04297,0 -23.625,-10.58203 -23.625,-23.625c0,-13.04297 10.58203,-23.625 23.625,-23.625c13.04297,0 23.625,10.58203 23.625,23.625z" fill="#6e727a"></path><path d="M137.05884,144.84155l71.87475,-41.6206l-10.24365,-21.67163z" fill="#a8b7d1"></path><path d="M170.85059,50.51074l-21.07178,75.48926l-0.15381,-86.07129c6.33691,2.12256 12.36621,4.92188 17.9187,8.38257c1.13819,0.70752 2.24561,1.41504 3.30689,2.19946z" fill="#a8b7d1"></path><path d="M73.24365,191.39941l21.0564,-75.47388l0.15381,86.07129c-6.33691,-2.12256 -12.35083,-4.92187 -17.90332,-8.38257c-1.15356,-0.7229 -2.2456,-1.43042 -3.30688,-2.21484z" fill="#a8b7d1"></path><path d="M194.59863,171.32739l-77.68872,-21.70239l87.28638,-0.15381c-2.19946,7.79809 -5.42944,15.15015 -9.59766,21.8562z" fill="#a8b7d1"></path><path d="M51.69507,72.79761l77.68872,21.70239l-87.28638,0.15381c2.19946,-7.7981 5.42945,-15.15015 9.59766,-21.8562z" fill="#a8b7d1"></path><path d="M38.14453,136.6897l70.38281,-39.40576l-61.76953,61.67725c-3.9375,-7.09058 -6.84448,-14.58105 -8.61328,-22.27148z" fill="#a8b7d1"></path><path d="M106.09717,37.66772l39.59033,70.27515l-61.83105,-61.61572c7.05982,-3.95288 14.55029,-6.87525 22.24072,-8.65942z" fill="#a8b7d1"></path><path d="M138.05859,206.45728l-39.59033,-70.27515l61.84643,61.61572c-7.09058,3.95288 -14.56567,6.87525 -22.2561,8.65942z" fill="#a8b7d1"></path><path d="M122.0625,7.875c-62.96924,0 -114.1875,51.23364 -114.1875,114.1875c0,62.95386 51.21826,114.1875 114.1875,114.1875c62.96924,0 114.1875,-51.23364 114.1875,-114.1875c0,-62.95386 -51.21826,-114.1875 -114.1875,-114.1875zM122.0625,228.375c-58.61646,0 -106.3125,-47.69604 -106.3125,-106.3125c0,-58.61646 47.69604,-106.3125 106.3125,-106.3125c58.61646,0 106.3125,47.69604 106.3125,106.3125c0,58.61646 -47.69604,106.3125 -106.3125,106.3125z" fill="#986ca1"></path><path d="M175.95703,59.32397c0.73828,0.646 1.66113,0.95362 2.5686,0.95362c1.10742,0 2.19946,-0.46143 2.98388,-1.3689c1.41504,-1.64575 1.23047,-4.13745 -0.41528,-5.55249c-2.4917,-2.13794 -5.12183,-4.16821 -7.82886,-6.0293c-1.79956,-1.23047 -4.24512,-0.76904 -5.47559,1.01514c-1.23047,1.79956 -0.78442,4.24512 1.01514,5.47559c2.47632,1.70728 4.87573,3.55298 7.1521,5.50635z" fill="#986ca1"></path><path d="M192.58374,65.23022c-1.3689,-1.69189 -3.84521,-1.95337 -5.53711,-0.58447c-1.69189,1.3689 -1.95337,3.84521 -0.59985,5.53711c2.32251,2.87622 4.36816,5.92163 6.27539,9.05933l-43.09717,43.09717v-78.16553c1.89185,0.67676 3.78369,1.32276 5.6294,2.13794c1.99951,0.86133 4.32202,-0.03076 5.18335,-2.03027c0.87671,-1.98413 -0.03076,-4.30664 -2.01489,-5.18335c-11.4895,-5.04492 -23.71728,-7.59815 -36.36035,-7.59815c-15.8269,0 -30.7002,4.09131 -43.66626,11.25879c-0.10766,0.03076 -0.19995,0.12305 -0.29223,0.16919c-27.77783,15.48853 -46.60401,45.14282 -46.60401,79.13452c0,15.8269 4.09131,30.71558 11.25879,43.66626c0.03076,0.09228 0.10767,0.16919 0.13843,0.26147c15.48853,27.79321 45.1582,46.63477 79.16528,46.63477c15.8269,0 30.7002,-4.09131 43.66626,-11.25879c0.10767,-0.03076 0.19995,-0.12305 0.29224,-0.16919c27.77783,-15.48852 46.604,-45.14282 46.604,-79.13452c0,-20.62573 -7.12134,-40.80542 -20.04126,-56.83228zM204.75,122.0625c0,6.79834 -0.90747,13.36597 -2.47632,19.6875h-60.92358l55.27881,-55.27881c5.26026,11.05883 8.12109,23.2251 8.12109,35.59131zM130.41431,141.55005c-0.06152,0.06152 -0.0769,0.13843 -0.12305,0.19995h-16.10376c-0.0769,0 -0.15381,0.04614 -0.23071,0.04614l-11.38184,-11.38184c-0.06152,-0.06152 -0.13843,-0.0769 -0.19995,-0.12305v-16.10376c0,-0.0769 -0.04614,-0.15381 -0.04614,-0.23071l11.38184,-11.38184c0.06152,-0.06152 0.07691,-0.13843 0.12305,-0.19995h16.10376c0.0769,0 0.15381,-0.04614 0.23071,-0.04614l11.38184,11.38184c0.06152,0.06152 0.13843,0.07691 0.19995,0.12305v16.10376c0,0.0769 0.04614,0.15381 0.04614,0.23071zM141.75,41.82056v60.95435l-55.24805,-55.24805c10.79737,-5.16797 22.8252,-8.15186 35.56055,-8.15186c6.72143,0 13.28906,0.89209 19.6875,2.44556zM79.28833,51.43359l43.05103,43.06641h-78.13477c6.41382,-18.07251 18.91846,-33.23804 35.08374,-43.06641zM41.85132,102.375h60.92359l-55.24805,55.24805c-5.16797,-10.79736 -8.15186,-22.8252 -8.15186,-35.56055c0,-6.79834 0.90747,-13.36597 2.47632,-19.6875zM51.43359,164.83667l43.06641,-43.05102v78.13477c-18.07251,-6.41382 -33.23804,-18.91846 -43.06641,-35.08374zM102.375,202.27368v-60.92358l55.24805,55.24805c-10.79736,5.16797 -22.8252,8.15185 -35.56055,8.15185c-6.79834,0 -13.36597,-0.90747 -19.6875,-2.47632zM164.83667,192.69141l-43.05102,-43.06641h78.13477c-6.41382,18.07251 -18.91846,33.23804 -35.08374,43.06641z" fill="#986ca1"></path></g></g><g><g id="Layer_1"><path d="M145.66362,125.3042l9.33135,38.74284l-34.05748,-21.37943l-34.05748,21.37943l2.83484,-11.81184l1.88989,-7.87456l4.60662,-19.05644l-30.39581,-26.97037l40.27838,-3.70104l14.84355,-36.89232l11.81184,29.37211l3.03171,7.52021l4.84286,0.4331l35.43552,3.26794z" fill="#f9e3ae"></path><path d="M145.66362,125.3042l9.33135,38.74284l-34.05748,-21.37943v-84.92714l11.81184,29.37211l3.03171,7.52021l4.84286,0.4331l35.43552,3.26794z" fill="#f6d397"></path><path d="M155.00285,167c-0.66934,0 -1.34261,-0.1693 -1.94502,-0.51578l-32.12033,-18.26504l-32.12033,18.26504c-1.35049,0.76777 -3.03171,0.66934 -4.28376,-0.25199c-1.25206,-0.92526 -1.84265,-2.50017 -1.50798,-4.01996l7.83913,-35.34103l-27.63971,-24.11191c-1.18512,-1.03157 -1.64185,-2.66948 -1.1615,-4.16564c0.47641,-1.49617 1.79934,-2.56317 3.36244,-2.71672l36.95925,-3.6538l14.9656,-33.14796c0.6339,-1.41348 2.03557,-2.31906 3.58686,-2.31906c1.55129,0 2.95296,0.90557 3.58686,2.31512l14.9656,33.14796l36.95925,3.6538c1.55916,0.15355 2.88209,1.22449 3.36244,2.71672c0.48035,1.49617 0.02362,3.13408 -1.1615,4.16564l-27.63971,24.11191l7.83913,35.34103c0.33467,1.51979 -0.25199,3.0947 -1.50798,4.01996c-0.69296,0.51185 -1.51192,0.77171 -2.33874,0.77171zM120.9375,139.75402c0.67327,0 1.34261,0.1693 1.94502,0.51578l26.35616,14.98923l-6.42564,-28.96264c-0.31105,-1.40561 0.1693,-2.87028 1.25599,-3.81916l22.53306,-19.65884l-30.15563,-2.98052c-1.39773,-0.1378 -2.62223,-1.01582 -3.20101,-2.29543l-12.30794,-27.27748l-12.31188,27.27354c-0.57484,1.28355 -1.79934,2.15763 -3.20101,2.29543l-30.15563,2.98052l22.53306,19.65884c1.08669,0.94495 1.56704,2.41355 1.25599,3.81916l-6.42564,28.96264l26.35616,-14.98923c0.60634,-0.34254 1.27568,-0.51185 1.94895,-0.51185z" fill="#8d6c9f"></path></g></g><path d="M126,252c-69.58788,0 -126,-56.41212 -126,-126v0c0,-69.58788 56.41212,-126 126,-126v0c69.58788,0 126,56.41212 126,126v0c0,69.58788 -56.41212,126 -126,126z" fill="none"></path><path d="M126,246.96c-66.80436,0 -120.96,-54.15564 -120.96,-120.96v0c0,-66.80436 54.15564,-120.96 120.96,-120.96h0c66.80436,0 120.96,54.15564 120.96,120.96v0c0,66.80436 -54.15564,120.96 -120.96,120.96z" fill="none"></path><path d="" fill="none"></path><path d="" fill="none"></path><path d="" fill="none"></path></g></g></svg>