Tidy up .rubocopy.yml

This alphabetizes the configuration for rubocop.yml and preps for a
rubocop auto-config so we're not constantly hit with warnings.

Author: Tod Beardsley

.rubocop.yml

@@ -1,19 +1,43 @@
-LineLength:
-  Enabled: true
-  Max: 180
+# This list was created by analyzing the last three months (51 modules)
+# committed to Metasploit Framework. Many, many older modules will have
+# offenses, but this should at least provide a baseline for new modules.
+#
+# Updates to this file should include a 'Description' parameter for
+# any explaination needed.
 
-MethodLength:
-  Enabled: true
-  Max: 100
+# inherit_from: .rubocop_todo.yml
 
 Style/ClassLength:
+  Description: 'Most Metasploit modules are quite large. This is ok.'
+  Enabled: true
   Exclude:
-    # Most modules are quite large and all contained in one class.  This is OK.
     - 'modules/**/*'
 
-Style/NumericLiterals:
-  Enabled: false
-
-Documentation:
+Style/Documentation:
+  Enabled: true
+  Description: 'Most Metasploit modules do not have class documentation.'
   Exclude:
     - 'modules/**/*'
+
+Style/Encoding:
+  Enabled: true
+  Description: 'We prefer binary to UTF-8.'
+  EnforcedStyle: 'when_needed'
+
+Style/LineLength:
+  Description: >-
+                  Metasploit modules often pattern match against very
+                  long strings when identifying targets.
+  Enabled: true
+  Max: 180
+
+Style/MethodLength:
+  Enabled: true
+  Description: >-
+                  While the style guide suggests 10 lines, exploit definitions
+                  often exceed 200 lines.
+  Max: 300
+
+Style/NumericLiterals:
+  Enabled: false
+  Description: 'This often hurts readability for exploit-ish code.'