Docs: fixer-return.md

Author: aladdin-add

docs/rules/fixer-return.md

@@ -0,0 +1,41 @@
+# Enforces always return from a fixer function (fixer-return)
+
+In a fixable rule, missing return from a fixer function will not apply fixes.
+
+## Rule Details
+
+This rule enforces always return from a fixer function.
+
+Examples of **incorrect** code for this rule:
+
+```js
+/* eslint eslint-plugin/fixer-return: error */
+module.exports = {
+    create: function(context) {
+        context.report( {
+            fix: function(fixer) {
+                fixer.foo();
+            }
+        });
+    }
+};
+```
+
+Examples of **correct** code for this rule:
+
+```js
+/* eslint eslint-plugin/fixer-return: error */
+module.exports = {
+    create: function(context) {
+        context.report( {
+            fix: function(fixer) {
+                return fixer.foo();
+            }
+        });
+    }
+};
+```
+
+## When Not To Use It
+
+If you don't want to enforce always return from a fixer function, do not enable this rule.

lib/rules/fixer-return.js

@@ -1,5 +1,5 @@
 /**
- * @fileoverview enforces fixer function always return a value
+ * @fileoverview Enforces always return from a fixer function
  * @author 薛定谔的猫<[email protected]>
  */
 

tests/lib/rules/fixer-return.js

@@ -1,5 +1,5 @@
 /**
- * @fileoverview enforces fixer function always return a value
+ * @fileoverview enforces always return from a fixer function
  * @author 薛定谔的猫<[email protected]>
  */