diff --git a/doc/faqs/vendor-bins.md b/doc/faqs/vendor-bins.md
index b6cf8dfed..f904f54c0 100644
--- a/doc/faqs/vendor-bins.md
+++ b/doc/faqs/vendor-bins.md
@@ -6,7 +6,7 @@ Any runnable code that a Composer package would like to pass along
 to a user who installs the package should be listed as a bin.
 
 If a package contains other runnable code that is not needed by the
-user (like build or compile scripts) that code need not be listed
+user (like build or compile scripts) that code should not be listed
 as a bin.
 
 
@@ -16,11 +16,11 @@ It is defined by adding the `bin` key to a project's `composer.json`.
 It is specified as an array of files so multiple bins can be added
 for any given project.
 
-~~~json
+```json
 {
     "bin": ["bin/my-script", "bin/my-other-script"]
 }
-~~~
+```
 
 
 ## What does defining a bin in composer.json do?
@@ -44,29 +44,36 @@ symlink is created from each dependency's bins to `vendor/bin`.
 
 Say package `my-vendor/project-a` has bins setup like this:
 
-~~~json
+```json
 {
     "name": "my-vendor/project-a",
     "bin": ["bin/project-a-bin"]
 }
-~~~
+```
 
 Running `composer install` for this `composer.json` will not do
 anything with `bin/project-a-bin`.
 
 Say project `my-vendor/project-b` has requirements setup like this:
 
-~~~json
+```json
 {
     "name": "my-vendor/project-b",
     "requires": {
         "my-vendor/project-a": "*"
     }
 }
-~~~
+```
 
 Running `composer install` for this `composer.json` will look at
 all of project-b's dependencies and install them to `vendor/bin`.
 
 In this case, Composer will create a symlink from
-`vendor/my-vendor/project-a/bin/project-a-bin` to `vendor/bin/project-a-bin`.
\ No newline at end of file
+`vendor/my-vendor/project-a/bin/project-a-bin` to `vendor/bin/project-a-bin`.
+
+
+## What about Windows and .bat files?
+
+Composer will automatically create `.bat` files for bins installed in a
+Windows environment. Package maintainers should not list self managed
+`.bat` files as bins.
\ No newline at end of file