diff --git a/README.md b/README.md
index 8ffafdc4c4..b651ea3157 100644
--- a/README.md
+++ b/README.md
@@ -1,18 +1,18 @@
-[](http://twitter.com/philippjahoda)
-[](http://twitter.com/mpandroidchart)
-[](http://android-arsenal.com/details/1/741)
-[](https://jitpack.io/#PhilJay/MPAndroidChart) [](https://android-arsenal.com/api?level=8)
+**Remember: _It's all about the looks._**
-Remember: *It's all about the looks.*
+
-
+[](https://jitpack.io/#PhilJay/MPAndroidChart)
+[](https://android-arsenal.com/api?level=8)
+[](http://android-arsenal.com/details/1/741)
+[](https://gitter.im/PhilJay/MPAndroidChart?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=body_badge)
+[](http://twitter.com/mpandroidchart)
-[**MPAndroidChart**](https://github.com/PhilJay/MPAndroidChart) :zap: is a powerful & easy to use chart library for Android. It runs on [API level 8](http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) and upwards.
+:zap: A powerful & easy to use chart library for Android :zap:
-As an additional feature, this library allows cross-platform development between Android and iOS as an iOS version of this library is also available: [**Charts**](https://github.com/danielgindi/Charts) :zap:
+[**Charts**](https://github.com/danielgindi/Charts) is the iOS version of this library
-[Enterprise Solution 5% Discount Coupon | SciChart](http://store.scichart.com?productTab=Android&CouponCode=MPANDROIDCHART)
------
+## [Enterprise Solution 5% Discount Coupon | SciChart](http://store.scichart.com?productTab=Android&CouponCode=MPANDROIDCHART)
@@ -24,177 +24,178 @@ MPAndroidChart is free software, as a result **dynamic & realtime data is not of
All MPAndroidChart users are entitled to a special **discount of 5%** off the SciChart store, using the following discount code: **MPANDROIDCHART**
+
+## Usage :chart_with_upwards_trend:
-
+**Gradle**
+- **Project level `build.gradle`**
+```gradle
+allprojects {
+ repositories {
+ maven { url 'https://jitpack.io' }
+ }
+}
+```
+- **App level `build.gradle`**
+```gradle
+dependencies {
+ implementation 'com.github.PhilJay:MPAndroidChart:v3.0.3'
+}
+```
-Donations
------
+**Maven**
-**This project needs you!** If you would like to support this project's further development, the creator of this project or the continuous maintenance of this project, **feel free to donate**. Your donation is highly appreciated (and I love food, coffee and beer). Thank you!
+```xml
+
+
+ jitpack.io
+ https://jitpack.io
+
-**My Bitcoin Wallet** (Bitcoin only)
-1G8G6tqQ3oh38BvDH3xq8o6gGVMvBTkcUg
+
+
+ com.github.PhilJay
+ MPAndroidChart
+ v3.0.3
+
+```
-**My Ethereum Wallet** (Ethereum only)
+
-0x04ef098bf9f91871391363e3caf791afa3adc39b
+## Documentation :notebook_with_decorative_cover:
-**PayPal**
+See the [**documentation**](https://github.com/PhilJay/MPAndroidChart/wiki) for examples and general use of MPAndroidChart.
- - [**Donate 5 $**](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=7G52RA87ED8NY): Thank's for creating this project, here's a coffee (or some beer) for you!
- - [**Donate 10 $**](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=4C9TPE67F5PUQ): Wow, I am stunned. Let me take you to the movies!
- - [**Donate 15 $**](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=YKMPTFMVK3JMC): I really appreciate your work, let's grab some lunch!
- - [**Donate 25 $**](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=H9JA4QX7UHXCY): That's some awesome stuff you did right there, dinner is on me!
- - Or you can also [**choose what you want to donate**](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=EGBENAC5XBCKS), all donations are awesome!
+See the [**javadocs**](https://jitpack.io/com/github/PhilJay/MPAndroidChart/v3.0.3/javadoc/) for more advanced documentation.
+
-Spread the word
------
+## Examples :eyes:
+Download the [MPAndroidChart Example App](https://play.google.com/store/apps/details?id=com.xxmassdeveloper.mpchartexample) or look at the [source code](https://github.com/PhilJay/MPAndroidChart/tree/master/MPChartExample).
-If you like this library, please tell others about it :two_hearts: :two_hearts:
+[](https://www.youtube.com/watch?v=ufaK_Hd6BpI)
-
-
-
+
- - []()Follow me on **Twitter**: [**@PhilippJahoda**](https://twitter.com/PhilippJahoda)
- - Look me up on **StackOverflow**: [**Philipp Jahoda**](http://stackoverflow.com/users/1590502/philipp-jahoda)
+## Questions & Issues :thinking:
+This repository's issue tracker is only for bugs and feature requests. The maintainers ask that you refrain from asking questions about how to use MPAndroidChart through the issue tracker.
-Demo
------
+Please read the [**documentation**](https://github.com/PhilJay/MPAndroidChart/wiki) first, then ask all your questions on [stackoverflow.com](https://stackoverflow.com/questions/tagged/mpandroidchart) for the fastest answer.
-For a brief overview of the most important features, please download the **PlayStore Demo** [**MPAndroidChart Example.apk**](https://play.google.com/store/apps/details?id=com.xxmassdeveloper.mpchartexample) and try it out. The corresponding code for the demo-application is also included in this repository inside the **MPChartExample folder**.
+
-[](https://www.youtube.com/watch?v=ufaK_Hd6BpI)
+## Donations :heart:
-Questions & Issues
------
+**This project needs you!** If you would like to support this project's further development, the creator of this project or the continuous maintenance of this project, **feel free to donate**. Your donation is highly appreciated (and I love food, coffee and beer). Thank you!
-If you are having questions or problems, you should:
+**My Bitcoin Wallet** (Bitcoin only)
- - **Review your code**. Make absolutely sure that everything is correct on your side.
- - Make sure you are using the **latest version** of the library. Check the [**release-section**](https://github.com/PhilJay/MPAndroidChart/releases).
- - Study the [**Documentation-Wiki**](https://github.com/PhilJay/MPAndroidChart/wiki) or the [javadocs](https://jitpack.io/com/github/PhilJay/MPAndroidChart/v3.0.3/javadoc/)
- - Search or open questions on [**stackoverflow**](https://stackoverflow.com/search?q=mpandroidchart) with the `mpandroidchart` tag
- - Search [**known issues**](https://github.com/PhilJay/MPAndroidChart/issues) for your problem (open and closed)
- - Create new issues (please :fire: **search known issues before** :fire:, do not create duplicate issues)
- - Check this: ["how not to contribute"](https://github.com/PhilJay/MPAndroidChart/wiki/How-not-to-contribute)
-
-Please do not expect answers to your questions if you have not considered all above mentioned approaches in advance.
+1G8G6tqQ3oh38BvDH3xq8o6gGVMvBTkcUg
-Features
------
-You can have a look at the core features of this libary [**here**](https://github.com/PhilJay/MPAndroidChart/wiki/Core-Features).
-
-Usage
------
+**My Ethereum Wallet** (Ethereum only)
-In order to use the library, there are 4 different options:
+0x04ef098bf9f91871391363e3caf791afa3adc39b
-**1. Gradle dependency** (recommended)
+**PayPal**
- - Add the following to your project level `build.gradle`:
-
-```gradle
-allprojects {
- repositories {
- maven { url "https://jitpack.io" }
- }
-}
-```
- - Add this to your app `build.gradle`:
-
-```gradle
-dependencies {
- implementation 'com.github.PhilJay:MPAndroidChart:v3.0.3'
-}
-```
+- [**Donate 5 $**](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=7G52RA87ED8NY): Thank's for creating this project, here's a coffee (or some beer) for you!
+- [**Donate 10 $**](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=4C9TPE67F5PUQ): Wow, I am stunned. Let me take you to the movies!
+- [**Donate 15 $**](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=YKMPTFMVK3JMC): I really appreciate your work, let's grab some lunch!
+- [**Donate 25 $**](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=H9JA4QX7UHXCY): That's some awesome stuff you did right there, dinner is on me!
+- Or you can also [**choose what you want to donate**](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=EGBENAC5XBCKS), all donations are awesome!
-**2. Maven**
-- Add the following to the `` section of your `pom.xml`:
+
- ```xml
-
- jitpack.io
- https://jitpack.io
-
-```
-- Add the following to the `` section of your `pom.xml`:
+## Social Media :fire:
- ```xml
-
- com.github.PhilJay
- MPAndroidChart
- v3.0.3
-
-```
-
-**3. clone whole repository** (not recommended)
+If you like this library, please tell others about it :two_hearts: :two_hearts:
+
+[](https://twitter.com/intent/tweet?text=Check%20out%20the%20awesome%20MPAndroidChart%20library%20on%20Github:%20https://github.com/PhilJay/MPAndroidChart)
+[](https://plus.google.com/share?url=https://github.com/PhilJay/MPAndroidChart)
+[](https://www.facebook.com/sharer/sharer.php?u=https://github.com/PhilJay/MPAndroidChart)
-Documentation
------
-For a **detailed documentation** :notebook_with_decorative_cover:, please have a look at the [**Wiki**](https://github.com/PhilJay/MPAndroidChart/wiki) or the [javadocs](https://jitpack.io/com/github/PhilJay/MPAndroidChart/v3.0.3/javadoc/).
+You can follow the creator on Twitter [**@PhilippJahoda**](https://twitter.com/PhilippJahoda)
-Furthermore, you can also rely on the [**MPChartExample**](https://github.com/PhilJay/MPAndroidChart/tree/master/MPChartExample) folder and check out the example code in that project. The corresponding application to the example project is also [**available in the Google PlayStore**](https://play.google.com/store/apps/details?id=com.xxmassdeveloper.mpchartexample).
-You can also join others in a discussion on [](https://gitter.im/PhilJay/MPAndroidChart?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=body_badge)
-
-Chart types
------
+Philipp is also on [StackOverflow](http://stackoverflow.com/users/1590502/philipp-jahoda)
+
+
+
+## More Examples :+1:
+
+
+
+**LineChart (with legend, simple design)**
- - **LineChart (with legend, simple design)**
- - **LineChart (with legend, simple design)**
+
+
+**LineChart (with legend, simple design)**
+
+
+
+**LineChart (cubic lines)**
- - **LineChart (cubic lines)**
+
- - **LineChart (gradient fill)**
-
+**LineChart (gradient fill)**
- - **Combined-Chart (bar- and linechart in this case)**
-
+
+
- - **BarChart (with legend, simple design)**
+**BarChart (with legend, simple design)**
+
- - **BarChart (grouped DataSets)**
+**BarChart (grouped DataSets)**
+
- - **Horizontal-BarChart**
+**Horizontal-BarChart**
+
+
+**Combined-Chart (bar- and linechart in this case)**
+
+
- - **PieChart (with selection, ...)**
+**PieChart (with selection, ...)**
+
- - **ScatterChart** (with squares, triangles, circles, ... and more)
+**ScatterChart** (with squares, triangles, circles, ... and more)
+
- - **CandleStickChart** (for financial data)
+**CandleStickChart** (for financial data)
+
- - **BubbleChart** (area covered by bubbles indicates the yValue)
+**BubbleChart** (area covered by bubbles indicates the yValue)
+
- - **RadarChart** (spider web chart)
+**RadarChart** (spider web chart)
+
+
+# License :page_facing_up:
-License
-=======
Copyright 2018 Philipp Jahoda
Licensed under the Apache License, Version 2.0 (the "License");
@@ -209,4 +210,14 @@ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-**Special thanks** to [danielgindi](https://github.com/danielgindi), [mikegr](https://github.com/mikegr), [tony](https://github.com/tonypatino-monoclesociety), [almic](https://github.com/almic) and [jitpack.io](https://github.com/jitpack-io) for their contributions to this project.
+
+
+## Special Thanks :heart:
+
+These people rock!
+
+- [danielgindi](https://github.com/danielgindi) - Daniel Gindi
+- [mikegr](https://github.com/mikegr) - Michael Greifeneder
+- [tony](https://github.com/tonypatino-monoclesociety) - Tony
+- [almic](https://github.com/almic) - Mick A.
+- [jitpack.io](https://github.com/jitpack-io) - JitPack.io
diff --git a/design/feature_graphic_smaller.png b/design/feature_graphic_smaller.png
new file mode 100644
index 0000000000..c1e5db5799
Binary files /dev/null and b/design/feature_graphic_smaller.png differ