Merge pull request #159 from ember-learn/module-links

Fix links to module items and provide sample docs

Author: dfreeman

lib/broccoli/docs-compiler.js

@@ -180,7 +180,7 @@ function generateModuleNavigationItems(modules, type) {
   let navItems = modules.reduce((navItems, m) => {
     let items = m[type].map((item) => {
       return {
-        path: `root/${item.id || module.id}`,
+        path: `root/${item.id || m.id}`,
         name: item.name,
         isDefault: item.exportType === 'default'
       };

sandbox/app/utils/esdoc-module.js

@@ -0,0 +1,18 @@
+/** @documenter esdoc */
+
+/**
+ * A first-class greeting for the people.
+ *
+ * @type {string}
+ */
+export const GREETING = 'Hello';
+
+/**
+ * Greet whoever you like!
+ *
+ * @param {string} subject The target of your greeting
+ * @return {string} A hand-crafted artisanal greeting just for your subject
+ */
+export function greet(subject = 'World') {
+  return `${GREETING}, ${subject}!`;
+}

sandbox/app/utils/yuidoc-module.js

@@ -0,0 +1,20 @@
+/** @documenter yuidoc */
+
+/**
+ * A first-class greeting for the people.
+ *
+ * @constant GREETING
+ * @type {string}
+ */
+export const GREETING = 'Hello';
+
+/**
+ * Greet whoever you like!
+ *
+ * @function greet
+ * @param {string} subject The target of your greeting
+ * @return {string} A hand-crafted artisanal greeting just for your subject
+ */
+export function greet(subject = 'World') {
+  return `${GREETING}, ${subject}!`;
+}