Add sassdoc

.sassdocrc

@@ -0,0 +1,9 @@
+{
+  "package": {
+    "title": "Sass Deprecate",
+    "name": "sass-deprecate",
+    "homepage": "https://github.com/salesforce-ux/sass-deprecate",
+    "description": "deprecate() is a Sass mixin that helps managing code deprecation."
+  },
+  "autofill": "false"
+}

index.scss

@@ -27,7 +27,7 @@ $deprecate-mode: 'sensible' !default;
 ///
 /// @return {Number}
 /// @author @HugoGiraudel - Simplified by @kaelig to only convert unsigned integers
-/// @see http://hugogiraudel.com/2014/01/15/sass-string-to-number/
+/// @url http://hugogiraudel.com/2014/01/15/sass-string-to-number/
 /// @access private
 @function _d-to-number($value) {
   $result: 0;

package.json

@@ -9,18 +9,21 @@
   },
   "author": "Salesforce and contributors",
   "scripts": {
-    "test": "./test/spec.rb"
+    "test": "./test/spec.rb",
+    "generate-docs": "./sassdoc.sh"
   },
   "files": [
     "index.scss",
     "README.md"
   ],
   "ignore": [
-    ".travis.yml",
-    ".gitignore",
-    "test"
+    "test",
+    "sassdoc",
+    "**/.*",
+    "sassdoc.sh"
   ],
   "devDependencies": {
-    "node-sass": "^3.4.2"
+    "node-sass": "^3.4.2",
+    "sassdoc": "^2.1.19"
   }
 }

sassdoc.sh

@@ -0,0 +1,7 @@
+#!/bin/sh
+# Generate documentation and deploy it to GitHub pages
+# http://salesforce-ux.github.io/sass-deprecate/
+sassdoc . sassdoc --config=.sassdocrc
+git add sassdoc
+git commit -m "Compile SassDoc"
+git subtree push --prefix sassdoc origin gh-pages