Add documentation for exports-last

Author: k15a

Diff for: CHANGELOG.md

@@ -26,6 +26,9 @@ This change log adheres to standards from [Keep a CHANGELOG](http://keepachangel
 - Properly report [`newline-after-import`] when next line is a decorator
 - Fixed documentation for the default values for the [`order`] rule ([#601])
 
+### Added
+- [`exports-last`] lints that export statements are at the end of the file ([#620] + [#632])
+
 ## [2.0.1] - 2016-10-06
 ### Fixed
 - Fixed code that relied on removed dependencies. ([#604])

Diff for: README.md

@@ -67,6 +67,7 @@ This plugin intends to support linting of ES2015+ (ES6+) import/export syntax, a
 **Style guide:**
 
 * Ensure all imports appear before other statements ([`first`])
+* Ensure all exports appear after other statements ([`exports-last`])
 * Report repeated import of the same module in multiple places ([`no-duplicates`])
 * Report namespace imports ([`no-namespace`])
 * Ensure consistent use of file extension within the import path ([`extensions`])
@@ -78,6 +79,7 @@ This plugin intends to support linting of ES2015+ (ES6+) import/export syntax, a
 * Forbid named default exports ([`no-named-default`])
 
 [`first`]: ./docs/rules/first.md
+[`exports-last`]: ./docs/rules/exports-last.md
 [`no-duplicates`]: ./docs/rules/no-duplicates.md
 [`no-namespace`]: ./docs/rules/no-namespace.md
 [`extensions`]: ./docs/rules/extensions.md

Diff for: docs/rules/exports-last.md

@@ -0,0 +1,41 @@
+# exports-last
+
+This rule reports all export declaration which come before any non-export statements.
+
+## This will be reported
+
+```JS
+
+const bool = true
+
+export default bool
+
+const str = 'foo'
+
+```
+
+```JS
+
+export const bool = true
+
+const str = 'foo'
+
+```
+
+## This will not be reported
+
+```JS
+export const bool = true
+
+export default bool
+
+export function func() {
+  console.log('Hello World 🌍')
+}
+
+export const str = 'foo'
+```
+
+## When Not To Use It
+
+If you don't mind exports being sprinkled throughout a file, you may not want to enable this rule.