diff --git a/.gitignore b/.gitignore
index 805473e..0710d97 100644
--- a/.gitignore
+++ b/.gitignore
@@ -106,4 +106,5 @@ venv.bak/
 # PyCharm IDEA files
 .idea
 .idea/
-.idea/*
\ No newline at end of file
+.idea/*
+.idea/workspace.xml
diff --git a/README.md b/README.md
index 5631ee7..0d836b4 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,47 @@
-# trendet - Python package for trend detection on stock time series
+# trendet - is a Python package for trend detection on stock time series data
+
+[![Python Version](https://img.shields.io/pypi/pyversions/trendet.svg)](https://pypi.org/project/trendet/)
+[![PyPi Version](https://img.shields.io/pypi/v/trendet.svg)](https://pypi.org/project/trendet/)
+[![Package Status](https://img.shields.io/pypi/status/trendet.svg)](https://pypi.org/project/trendet/)
+[![Build Status](https://dev.azure.com/alvarob96/alvarob96/_apis/build/status/alvarob96.trendet?branchName=master)](https://dev.azure.com/alvarob96/alvarob96/_build?definitionId=1&_a=summary)
+[![Build Status](https://img.shields.io/travis/alvarob96/trendet/master.svg?label=Travis%20CI&logo=travis&logoColor=white)](https://travis-ci.org/alvarob96/trendet)
+[![Documentation Status](https://readthedocs.org/projects/trendet/badge/?version=latest)](https://trendet.readthedocs.io/)
+[![Downloads](https://img.shields.io/pypi/dm/trendet.svg?style=flat)](https://pypistats.org/packages/trendet)
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/alvarob96/trendet/master/docs/trendet.jpg"/>
+</p>
+
+## Introduction
+
+**trendet** is a Python package to detect trends on the market so to analyze its behaviour. So on, this package
+has been created to support [investpy](https://github.com/alvarob96/investpy) features when it comes to data retrieval
+from different financial products such as stocks/equities, funds or ETFs. **trendet** is intended to be used combined
+with **investpy**, but also with every OHLC `pandas.DataFrame`. 
+
+## Installation
+
+In order to get this package working you will need to install it using pip by typing on the terminal:
+
+``$ python -m pip install trendet --upgrade``
+
+Or just install the current release or a specific release version such as:
+
+``$ python -m pip install trendet==0.1``
+
+## Contribute
+
+As this is an open source project it is open to contributions, bug reports, bug fixes, documentation improvements, 
+enhancements and ideas.
+
+Also there is an open tab of [issues](https://github.com/alvarob96/trendet/issues) where anyone can contribute opening 
+new issues if needed or navigate through them in order to solve them or contribute to its solving.
+
+## Disclaimer
+
+This package has been created so to identify market trends based on stock historical data retrieved via 
+[investpy](https://github.com/alvarob96/investpy) so to determine which trends have been prevailing on the market
+based on a single stock/equity OHLC values.
+
+Conclude that this is the result of a research project, so this package has been developed with research purposes and
+no profit is intended.
diff --git a/docs/trendet.jpg b/docs/trendet.jpg
new file mode 100644
index 0000000..e903846
Binary files /dev/null and b/docs/trendet.jpg differ
diff --git a/requirements.txt b/requirements.txt
new file mode 100644
index 0000000..978266b
--- /dev/null
+++ b/requirements.txt
@@ -0,0 +1,2 @@
+investpy==0.8.8
+setuptools==41.2.0
diff --git a/setup.py b/setup.py
index 47bcf4a..0624041 100644
--- a/setup.py
+++ b/setup.py
@@ -21,7 +21,10 @@ def readme():
     description='trendet - Python package for trend detection on stock time series',
     long_description=readme(),
     long_description_content_type='text/markdown',
-    install_requires=[],
+    install_requires=[
+        'investpy==0.8.8',
+        'setuptools==41.2.0'
+    ],
     data_files=[],
     include_package_data=True,
     classifiers=[
diff --git a/trendet/__init__.py b/trendet/__init__.py
index fc5808d..cf52e39 100644
--- a/trendet/__init__.py
+++ b/trendet/__init__.py
@@ -30,7 +30,7 @@ def identify_trends(equity, from_date, to_date, window_size=5, trend_limit=3, la
     Returns:
         :obj:`pandas.DataFrame`:
             The function returns a :obj:`pandas.DataFrame` which contains the retrieved historical data from Investing
-            using investpy, with a new column which identifies every trend found on the market between two dates
+            using `investpy`, with a new column which identifies every trend found on the market between two dates
             identifying when did the trend started and when did it end. So the additional column contains labeled date
             ranges.
     Raises: