diff --git a/debian/README.Debian b/debian/README.Debian
index 3adc26d1cb..d414849dbd 100644
--- a/debian/README.Debian
+++ b/debian/README.Debian
@@ -13,7 +13,8 @@ upstream still use gollum-grit_adapter. grit is no longer maintained and grit
 developers recommend switching to rugged. gollum-lib developers have announced
 their intention to switch to rugged_adapter by default and this is in progress.
 
-3. default paths: see /etc/gitlab/gitlab-debian.conf
+3. default paths: debian package has changed some default values for paths
+which you can see at /etc/gitlab/gitlab-debian.conf
 
 4. database: gitlab package configures postgresql database with peer
 authentication.
@@ -21,5 +22,9 @@ authentication.
 5. gem versions: some gem dependency requirements are relaxed to work with
 their packaged version in debian.
 
+You can find the list of gems required by gitlab and their corresponding
+package versions in debian at
+http://debian.fosscommunity.in/status/?appname=gitlab&sort=satisfied
+
 6. vendored js files: some embedded javascript files in vendor/assets/javascripts are
 replaced by their packaged verion.
diff --git a/debian/changelog b/debian/changelog
index 1af64912f9..227f41fd6b 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,3 +1,9 @@
+gitlab (8.4.0+dfsg~rc2-2) UNRELEASED; urgency=medium
+
+  * Add README.Debian to document debian specific changes 
+
+ -- Pirate Praveen <praveen@debian.org>  Fri, 22 Jan 2016 20:48:24 +0530
+
 gitlab (8.4.0+dfsg~rc2-1) experimental; urgency=medium
 
   * Initial release (Closes: #651606)