Document rubocop

README.md

@@ -149,7 +149,7 @@ Or, they can be passed to `prettier` as arguments:
 prettier --ruby-single-quote false --write '**/*.rb'
 ```
 
-## Use with RuboCop
+### Usage with RuboCop
 
 RuboCop and Prettier for Ruby serve different purposes, but there is overlap
 with some of RuboCop's functionality.

rubocop.yml

@@ -1,15 +1,26 @@
+# Disabling all Layout/* rules, as they're unnecessary when the user is using
+# prettier to handle all of the formatting.
+
 Layout:
   Enabled: false
 
-Style/MultilineIfModifier: # clashes with rubyModifier
+# Disabling all of the following options because they could conflict with a
+# prettier configuration setting.
+
+Style/MultilineIfModifier: # rubyModifier
   Enabled: false
-Style/SymbolArray: # clashes with rubyArrayLiteral
+
+Style/SymbolArray: # rubyArrayLiteral
   Enabled: false
-Style/WordArray: # clashes with rubyArrayLiteral
+
+Style/WordArray: # rubyArrayLiteral
   Enabled: false
-Style/TrailingCommaInArguments: # clashes with trailingComma
+
+Style/TrailingCommaInArguments: # trailingComma
   Enabled: false
-Style/TrailingCommaInArrayLiteral: # clashes with trailingComma
+
+Style/TrailingCommaInArrayLiteral: # trailingComma
   Enabled: false
-Style/TrailingCommaInHashLiteral: # clashes with trailingComma
+
+Style/TrailingCommaInHashLiteral: # trailingComma
   Enabled: false