diff --git a/l10n_us_ny_hr_payroll/README.rst b/l10n_us_ny_hr_payroll/README.rst
new file mode 100644
index 00000000..d732880c
--- /dev/null
+++ b/l10n_us_ny_hr_payroll/README.rst
@@ -0,0 +1,49 @@
+*************************************
+Hibou - US Payroll - New York State
+*************************************
+
+Calculations and contribution registers for New York State Payroll.
+
+For more information and add-ons, visit `Hibou.io <https://hibou.io/>`_.
+
+=============
+Main Features
+=============
+
+* New Partner and Contribution Register for New York Department of Taxation and Finance
+* Company level New York Unemployment Rate
+* Company level New York Re-employment Service Fund
+* Company level New York Metropolitan Commuter Transportation Mobility Tax
+* Contract level New York State Income Tax
+
+.. image:: https://user-images.githubusercontent.com/15882954/41480034-ef3aa5b8-7081-11e8-990d-3231ebfc2c16.png
+    :alt: 'Employee Contract Detail'
+    :width: 988
+    :align: left
+
+USA New York Employee Added to Salary Structure Menu
+
+.. image:: https://user-images.githubusercontent.com/15882954/41480052-fbad372a-7081-11e8-9421-996d26f449ab.png
+    :alt: 'Computed Pay Slip Detail'
+    :width: 988
+    :align: left
+
+New Payslip Categories for:
+
+* New York Income Withholding
+* New York Metropolitan Commuter Transportation Mobility Tax
+* New York Unemployment Insurance Tax - Wages
+* New York Unemployment Insurance Tax
+* New York Re-employment Service Fund
+
+=======
+Notes
+=======
+
+This module does not include tax rules for NYC and Yonkers.
+
+=======
+License
+=======
+Please see `LICENSE <https://github.com/hibou-io/hibou-odoo-suite/blob/master/LICENSE>`_.
+Copyright Hibou Corp. 2018