Add sassdoc and jsdoc generation tasks

.grunt-tasks/documentation.js

@@ -0,0 +1,14 @@
+module.exports = {
+	default : {
+		src: [
+			"src/javascripts/**/*.js",
+			"src/components/**/*.js",
+			"!src/components/**/*.test.js"
+		],
+		options: {
+			destination: "./dist/docs/js",
+			format: "json",
+			filename: "experience.json"
+		}
+	}
+};

.grunt-tasks/sassdoc.js

@@ -0,0 +1,5 @@
+module.exports = {
+	default: {
+		src: "./src/**/*.scss"
+	}
+};

.sassdocrc

@@ -0,0 +1,31 @@
+{
+	"dest": "./dist/docs/sass",
+	"exclude": [
+		"**/vendor/**/*.scss"
+	],
+	"display": {
+		"annotations": {
+			"function": ["description", "return", "throw", "require", "usedby", "since", "see", "todo", "link"],
+			"mixin": ["description", "content", "output", "throw", "require", "example", "usedby", "since", "see", "todo", "link"],
+			"placeholder": ["description", "example", "throw", "require", "usedby", "since", "see", "todo", "link"],
+			"variable": ["description", "type", "require", "example", "usedby", "since", "see", "todo", "link"],
+			"css": ["description", "require", "example", "usedby", "since", "see", "todo", "link"]
+		},
+		"access": ["public", "private"],
+		"alias": false,
+		"watermark": false
+	},
+	"groups": {
+		"undefined": "Ungrouped",
+		"general": "General",
+		"colors": "Colours",
+		"helpers": "Helpers",
+		"typography": "Typography",
+		"components": "Components",
+		"hacks": "Hacks",
+		"grid": "Grid",
+		"icons": "Icons"
+	},
+	"package": "./package.json",
+	"theme": "./src/stylesheets/.sassdoc-nice-theme"
+}

Gruntfile.js

@@ -32,14 +32,17 @@ module.exports = grunt => {
 
 	var r = grunt.registerTask;
 
+	// Generate documentation
+	r("docs", ["sassdoc", "documentation"]);
+
 	// Lint both SASS and JS
 	r("lint", ["sasslint", "eslint"]);
 
 	// Run JS unit tests
 	r("test", ["mochaTest"]);
 
 	// For building before publishing to NPM etc
-	r("prepublish", ["env:dist", "clean:dist", "lint", "test", "webfont:dist", "sass:dist", "postcss:dist", "cssmin:dist", "webpack"]);
+	r("prepublish", ["env:dist", "clean:dist", "lint", "test", "webfont:dist", "sass:dist", "postcss:dist", "cssmin:dist", "docs", "webpack"]);
 
 	r("default", ["env:dev", "clean:temp", "lint", "test", "webfont:temp", "sass:temp", "postcss:temp", "cssmin:temp", "watch"]);
 };