diff --git a/VisualStudio.gitignore b/VisualStudio.gitignore
index 9e002e3a..3ff15aef 100644
--- a/VisualStudio.gitignore
+++ b/VisualStudio.gitignore
@@ -152,7 +152,10 @@ AutoTest.Net/
 # Installshield output folder
 [Ee]xpress/
 
-# DocProject is a documentation generator add-in
+# DocProject
+# a document generation add-in for Visual Studio based on Sandcastle
+# url: http://docproject.codeplex.com/
+# remove: if you are using Visual Studio 2010 or later (which are not supported)
 DocProject/buildhelp/
 DocProject/Help/*.HxT
 DocProject/Help/*.HxC
@@ -170,8 +173,10 @@ publish/
 # Publish Web Output
 *.[Pp]ublish.xml
 *.azurePubxml
-# TODO: Comment the next line if you want to checkin your web deploy settings
-# but database connection strings (with potential passwords) will be unencrypted
+#
+# remove: if you have sensitive details in your database connection strings
+          (such as passwords) committing this settings file will mean
+          that they are stored in an unencrypted state in your repository
 *.pubxml
 *.publishproj
 
@@ -193,9 +198,9 @@ publish/
 # location and should be kept in version control
 !**/packages/build/
 #
-# this file is a local listing of where to find your  packages.config files and
+# this file is a local listing of where to find your packages.config files, and
 # is regenerated by Visual Studio during a build
-# include: if you wish to version this file any way
+# include: if you wish to version this file
 #!**/packages/repositories.config
 
 # Windows Azure Build Output