Add documentation for exports-last

CHANGELOG.md

@@ -7,6 +7,9 @@ This change log adheres to standards from [Keep a CHANGELOG](http://keepachangel
 ### Fixed
 - [`prefer-default-export`] handles re-exported default exports ([#609])
 
+### 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])

README.md

@@ -12,7 +12,7 @@ I want to apologize: I have been pretty unresponsive the last few weeks. My wife
 
 I am hoping to be back in action on this in the next week or two, but I need to focus on my family and work in the immediate term. Fortunately, @jfmengels is a fantastic co-maintainer and has been doing a great job responding to new issues in my absence.
 
-Thanks for your patience! 😎 
+Thanks for your patience! 😎
 
 -- @benmosher
 
@@ -79,6 +79,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`])
@@ -89,6 +90,7 @@ This plugin intends to support linting of ES2015+ (ES6+) import/export syntax, a
 * Forbid unassigned imports. ([`no-unassigned-import`])
 
 [`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

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.