From a9aad2945976db4bee16805b2df3ed2a44c5debd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=88=98=E7=A5=BA?= <gucong@gmail.com>
Date: Fri, 26 Jan 2018 15:54:36 +0800
Subject: [PATCH] Add SASS related content to the document (#3138)

---
 README.md                                | 2 +-
 docs/user-guide/cli.md                   | 4 ++--
 docs/user-guide/css-processors.md        | 1 +
 docs/user-guide/faq.md                   | 2 +-
 docs/user-guide/node-api.md              | 6 +++---
 lib/utils/isStandardSyntaxDeclaration.js | 4 ++--
 6 files changed, 10 insertions(+), 9 deletions(-)

diff --git a/README.md b/README.md
index a6e5b311e5..fa3535c897 100644
--- a/README.md
+++ b/README.md
@@ -19,7 +19,7 @@ A mighty, modern CSS linter and fixer that helps you avoid errors and enforce co
 -   **Automatically fixes some stylistic violations:** Save time by having stylelint fix your code with this *experimental* feature.
 -   **Shareable configs:** If you don't want to craft your own config, you can extend a shareable config. Or you can craft your own config and share with your team and/or the community.
 -   **Works with embedded styles:** Within `<style>` tags (used by Vue and Web Components) and Markdown code fences.
--   **Parses *CSS-like* syntaxes:** The linter is powered by [PostCSS](https://github.com/postcss/postcss), so it can be configured and extended to understand any syntax that PostCSS can parse, including SCSS, [SugarSS](https://github.com/postcss/sugarss), and Less.
+-   **Parses *CSS-like* syntaxes:** The linter is powered by [PostCSS](https://github.com/postcss/postcss), so it can be configured and extended to understand any syntax that PostCSS can parse, including Sass, [SugarSS](https://github.com/postcss/sugarss), and Less.
 -   **Options validator:** So that you can be confident that your config is valid.
 -   **Well tested:** Over ten thousand tests cover the internals and rules.
 -   **Growing community**: Used by [Facebook](https://code.facebook.com/posts/879890885467584/improving-css-quality-at-facebook-and-beyond/), [GitHub](https://github.com/primer/stylelint-config-primer), [Wikimedia](https://github.com/wikimedia/stylelint-config-wikimedia), [GSA](https://github.com/18F/stylelint-rules/), and [WordPress](https://github.com/ntwb/stylelint-config-wordpress/) among others.
diff --git a/docs/user-guide/cli.md b/docs/user-guide/cli.md
index 338104e667..39e82e29f0 100644
--- a/docs/user-guide/cli.md
+++ b/docs/user-guide/cli.md
@@ -68,9 +68,9 @@ Linting all the `.css` files in the `foo` directory, using the `syntax` option:
 stylelint "foo/**/*.css" --syntax scss
 ```
 
-In addition to `--syntax scss`, stylelint supports `--syntax less` and `--syntax sugarss` by default. If you're using one of the default syntaxes, you may not need to provide a `--syntax` option as non-standard syntaxes can be automatically inferred from the following:
+In addition to `--syntax scss`, stylelint supports `--syntax sass`, `--syntax less`, and `--syntax sugarss` by default. If you're using one of the default syntaxes, you may not need to provide a `--syntax` option as non-standard syntaxes can be automatically inferred from the following:
 
--   The following file extensions: `.less`, `.scss`, and `.sss`.
+-   The following file extensions: `.sass`, `.scss`, `.less`, and `.sss`.
 -   The following values for the `lang` or `type` attribute on `<style>` tags (e.g. `lang="scss"`, `type="text/scss"`): `scss`, `less` and `sugarss`.
 -   The following Markdown code fencing markers (e.g. ```` ```scss ````): `scss`, `less` and `sugarss`.
 
diff --git a/docs/user-guide/css-processors.md b/docs/user-guide/css-processors.md
index 5aafac413f..28111a7682 100644
--- a/docs/user-guide/css-processors.md
+++ b/docs/user-guide/css-processors.md
@@ -13,6 +13,7 @@ You can run the linter before or after your css processors. Depending on which p
 
 By default, the linter can *parse* any the following non-standard syntaxes by using special PostCSS parsers:
 
+-   Sass (using [`postcss-sass`](https://github.com/AleshaOleg/postcss-sass))
 -   SCSS (using [`postcss-scss`](https://github.com/postcss/postcss-scss))
 -   Less (using [`postcss-less`](https://github.com/shellscape/postcss-less))
 -   SugarSS (using [`sugarss`](https://github.com/postcss/sugarss))
diff --git a/docs/user-guide/faq.md b/docs/user-guide/faq.md
index 8e1fa7fd65..06646e80ea 100644
--- a/docs/user-guide/faq.md
+++ b/docs/user-guide/faq.md
@@ -45,7 +45,7 @@ The stylelint community also maintains a [handful of plugins](complementary-tool
 
 ## How do I lint SCSS, Less, or other non-standard syntax?
 
-stylelint can *parse* any the following non-standard syntaxes by default: SCSS, Less and SugarSS. Non-standard syntaxes can automatically be inferred from the following file extensions `.scss`, `.less`, and `.sss`; or else you can specify the syntax yourself.
+stylelint can *parse* any the following non-standard syntaxes by default: Sass, Less and SugarSS. Non-standard syntaxes can automatically be inferred from the following file extensions `.sass`, `.scss`, `.less`, and `.sss`; or else you can specify the syntax yourself.
 
 Additionally, stylelint can accept any [PostCSS-compatible syntax](https://github.com/postcss/postcss#syntaxes) when using the CLI or Node API. Note, however, that stylelint can provide no guarantee that core rules will work with syntaxes other than the defaults listed above.
 
diff --git a/docs/user-guide/node-api.md b/docs/user-guide/node-api.md
index 76571b9ba7..c612ddd644 100644
--- a/docs/user-guide/node-api.md
+++ b/docs/user-guide/node-api.md
@@ -109,7 +109,7 @@ Use this report to clean up your codebase, keeping only the stylelint-disable co
 
 ### `maxWarnings`
 
-Sets a limit to the number of warnings accepted. Will add a `maxWarningsExceeded` property to the returned data if the number of found warnings exceeds the given limit.  
+Sets a limit to the number of warnings accepted. Will add a `maxWarningsExceeded` property to the returned data if the number of found warnings exceeds the given limit.
 The value is an Object (e.g. `{ maxWarnings: 0, foundWarnings: 12 }`).
 
 *The recommended way to use this option is through the CLI.* It will exit with code 2 when `maxWarnings` is exceeded.
@@ -120,11 +120,11 @@ A path to a file containing patterns describing files to ignore. The path can be
 
 ### `syntax`
 
-Options: `"scss"|"less"|"sugarss"`
+Options: `"sass"|"scss"|"less"|"sugarss"`
 
 Specify a non-standard syntax that should be used to parse source stylesheets.
 
-If you do not specify a syntax, non-standard syntaxes will be automatically inferred by the file extensions `.scss`, `.less`, and `.sss`.
+If you do not specify a syntax, non-standard syntaxes will be automatically inferred by the file extensions `.sass`, `.scss`, `.less`, and `.sss`.
 
 See the [`customSyntax`](#customsyntax) option below if you would like to use stylelint with a custom syntax.
 
diff --git a/lib/utils/isStandardSyntaxDeclaration.js b/lib/utils/isStandardSyntaxDeclaration.js
index a5f24eba94..d832d8d712 100644
--- a/lib/utils/isStandardSyntaxDeclaration.js
+++ b/lib/utils/isStandardSyntaxDeclaration.js
@@ -14,7 +14,7 @@ module.exports = function(decl /*: Object*/) /*: boolean*/ {
     return false;
   }
 
-  // SASS/SCSS var (e.g. $var: x), nested list (e.g. $list: (x)) or nested map (e.g. $map: (key:value))
+  // Sass var (e.g. $var: x), nested list (e.g. $list: (x)) or nested map (e.g. $map: (key:value))
   if (prop[0] === "$") {
     return false;
   }
@@ -24,7 +24,7 @@ module.exports = function(decl /*: Object*/) /*: boolean*/ {
     return false;
   }
 
-  // SASS/SCSS nested properties (e.g. border: { style: solid; color: red; })
+  // Sass nested properties (e.g. border: { style: solid; color: red; })
   if (
     parent.selector &&
     parent.selector[parent.selector.length - 1] === ":" &&