diff --git a/README.md b/README.md
index 28fa02e0..89b4b15d 100644
--- a/README.md
+++ b/README.md
@@ -18,14 +18,15 @@ It is lightweight, flexible and easy-to-use, and based on a single all-purpose <
 Setting up the problem, defining additional constraints, modifying the algorithms and visualising the discovered solutions is as easy and handy as
 reading classical VRP instances to benchmark your algorithm. It is fit for change and extension due to a modular design and a comprehensive set of unit and integration-tests. [More features ...](https://github.com/jsprit/jsprit/wiki/features)
 
-##[Whats New](https://github.com/jsprit/jsprit/blob/master/WHATS_NEW.md)
-
 ##Getting Started and Documentation
-Please visit [docs](https://github.com/graphhopper/jsprit/blob/master/docs/Home.md) to learn more. For older versions (<v1.7) use [old-docs](https://github.com/graphhopper/jsprit/blob/master/docs/before-1.7/Home.md)
+Please visit [docs](https://github.com/graphhopper/jsprit/blob/master/docs/Home.md) to learn more. For older versions (<v1.7) use [old-docs](https://github.com/graphhopper/jsprit/blob/master/docs/before-1.7/Home.md). The best way to get to know jsprit is by looking at [code examples](https://github.com/graphhopper/jsprit/tree/master/jsprit-examples/src/main/java/com/graphhopper/jsprit/examples).
 
 ## Modules and Dependencies
 Please read [Notice.md](https://github.com/graphhopper/jsprit/blob/master/NOTICE.md) to get to know the direct dependencies of each module.
 
+##Whats New
+jsprit develops fast. Look [here](https://github.com/jsprit/jsprit/blob/master/WHATS_NEW.md) to get to know whats new.
+
 ##License
 This software is released under [Apache License v2](https://www.apache.org/licenses/LICENSE-2.0).
 
@@ -35,7 +36,8 @@ Any contribution is welcome. Feel free to improve jsprit and make pull requests.
 
 See who has contributed [here](https://github.com/jsprit/jsprit/blob/master/CONTRIBUTORS.md).
 
-##[Acknowledgement](https://github.com/jsprit/jsprit/wiki/Acknowledgement)
+##Acknowledgement
+Developing this would be much more difficult without the help of [these companies](https://github.com/graphhopper/jsprit/blob/master/docs/Acknowledgement.md).
 
 ##Contact
 
diff --git a/docs/Getting-Started.md b/docs/Getting-Started.md
index 5deab114..557acac9 100644
--- a/docs/Getting-Started.md
+++ b/docs/Getting-Started.md
@@ -39,7 +39,7 @@ Here you learn to setup the Java environment and an Integrated Development Envir
 #### If you do not want Maven
 to manage your dependencies, go to [maven central](https://search.maven.org/), search for jsprit and download the latest binaries to put them into your classpath.
 
-Go ahead and show me a simple example of how to setup and solve a vehicle routing problem.
+Go ahead and show me a [simple example](Simple-Example.md) of how to setup and solve a vehicle routing problem.
 
 
 
diff --git a/docs/Home.md b/docs/Home.md
index ca8666b9..6edad668 100644
--- a/docs/Home.md
+++ b/docs/Home.md
@@ -6,6 +6,7 @@ Setting up jsprit and the like.
 
 * [Simple Example](Simple-Example.md)
 * [More Examples](More-Examples.md)
+* [A number of various code examples](https://github.com/graphhopper/jsprit/tree/master/jsprit-examples/src/main/java/com/graphhopper/jsprit/examples)
 
 ## [Meta-Heuristic](Meta-Heuristic.md)