Info Architecture

antwar.config.js

@@ -13,155 +13,121 @@ module.exports = {
   layout: () => require('./src/components/Site/Site.jsx').default,
   paths: {
     '/': {
-      title: "Home",
-      content: () => require.context('./loaders/page-loader!./src/content', false, /^\.\/.*\.md$/),
-      index: () => {
-        const index = require('./src/components/Splash/Splash.jsx').default;
-        index.title = 'webpack';
-        index.description = 'webpack is a module bundler. Its main purpose is to bundle JavaScript files for usage in a browser, yet it is also capable of transforming, bundling, or packaging just about any resource or asset.';
-
-        return index;
-      },
+      title: 'Home',
       layout: () => require('./src/components/Page/Page.jsx').default,
-    },
-    'get-started': {
+      content: () => require.context('./loaders/page-loader!./src/content', false, /^\.\/.*\.md$/),
+      index: () => require('./src/components/Splash/Splash.jsx').default,
       redirects: {
-        '': '/guides/getting-started',
-        'install-webpack': '/guides/installation',
-        'why-webpack': '/guides/why-webpack',
+        'support': '/contribute',
+        'writers-guide': '/contribute/writers-guide'
       }
     },
-    api: {
-      title: "API",
-      layout: () => require('./src/components/Page/Page.jsx').default,
+    concepts: {
+      title: 'Concepts',
       url: ({ sectionName, fileName }) => `/${sectionName}/${fileName}/`,
-      content: () => require.context('./loaders/page-loader!./src/content/api', false, /^\.\/.*\.md$/),
-      transform: (pages) => {
-        return _.sortBy(pages, (page) => page.file.sort)
-      },
-      redirects: {
-        'passing-a-config': 'configuration-types'
-      }
+      layout: () => require('./src/components/Page/Page.jsx').default,
+      content: () => require.context('./loaders/page-loader!./src/content/concepts', false, /^\.\/.*\.md$/)
     },
-    'api/plugins': {
-      title: "API Plugins",
+    configuration: {
+      title: 'Configuration',
+      url: ({ sectionName, fileName }) => `/${sectionName}/${fileName}/`,
       layout: () => require('./src/components/Page/Page.jsx').default,
+      content: () => require.context('./loaders/page-loader!./src/content/configuration', false, /^\.\/.*\.md$/)
+    },
+    api: {
+      title: 'API',
       url: ({ sectionName, fileName }) => `/${sectionName}/${fileName}/`,
-      content: () => require.context('./loaders/page-loader!./src/content/api/plugins', false, /^\.\/.*\.md$/),
-      transform: (pages) => {
-        return _.sortBy(pages, (page) => page.file.sort)
-      },
+      layout: () => require('./src/components/Page/Page.jsx').default,
+      content: () => require.context('./loaders/page-loader!./src/content/api', false, /^\.\/.*\.md$/),
       redirects: {
         'passing-a-config': 'configuration-types'
       }
     },
-    pluginsapi: {
-      title: 'API Plugin',
-      redirects: {
-        '': '/api/plugins',
-        'compiler': '/api/plugins/compiler',
-        'template': '/api/plugins/template'
-      },
-      hideInSidebar: true
-    },
-    concepts: {
-      title: "Concepts",
-      layout: () => require('./src/components/Page/Page.jsx').default,
-      content: () => require.context('./loaders/page-loader!./src/content/concepts', false, /^\.\/.*\.md$/),
+    guides: {
+      title: 'Guides',
       url: ({ sectionName, fileName }) => `/${sectionName}/${fileName}/`,
-      transform: (pages) => {
-        return _.sortBy(pages, (page) => page.file.sort)
-      }
-    },
-    development: {
-      title: "Development",
       layout: () => require('./src/components/Page/Page.jsx').default,
-      content: () => require.context('./loaders/page-loader!./src/content/development', false, /^\.\/.*\.md$/),
-      url: ({ sectionName, fileName }) => `/${sectionName}/${fileName}/`,
-      transform: (pages) => {
-        return _.sortBy(pages, (page) => page.file.sort)
+      content: () => require.context('./loaders/page-loader!./src/content/guides', false, /^\.\/.*\.md$/),
+      redirects: {
+        'code-splitting-import': '/guides/code-splitting',
+        'code-splitting-require': '/guides/code-splitting',
+        'code-splitting-async': '/guides/code-splitting',
+        'code-splitting-css': '/guides/code-splitting',
+        'code-splitting-libraries': '/guides/code-splitting',
+        'why-webpack': '/comparison',
+        'production-build': '/guides/production'
       }
     },
     plugins: {
-      title: "Plugin",
+      title: 'Plugins',
+      url: ({ sectionName, fileName }) => `/${sectionName}/${fileName}/`,
+      layout: () => require('./src/components/Page/Page.jsx').default,
       content: () => {
         return combineContexts(
           require.context('./loaders/page-loader!./src/content/plugins', false, /^\.\/.*\.md$/),
           require.context('./loaders/page-loader!./generated/plugins', false, /^\.\/.*\.md$/)
         );
-      },
-      url: ({ sectionName, fileName }) => `/${sectionName}/${fileName}/`,
-      transform: (pages) => {
-        return _.sortBy(pages, (page) => page.file.sort)
-      },
-      layout: () => require('./src/components/Page/Page.jsx').default
+      }
     },
     loaders: {
-      title: "Loaders",
+      title: 'Loaders',
       url: ({ sectionName, fileName }) => `/${sectionName}/${fileName}/`,
       layout: () => require('./src/components/Page/Page.jsx').default,
       content: () => {
         return combineContexts(
           require.context('./loaders/page-loader!./src/content/loaders', false, /^\.\/.*\.md$/),
           require.context('./loaders/page-loader!./generated/loaders', false, /^\.\/.*\.md$/)
         );
-      },
+      }
     },
-    guides: {
-      title: "Guides",
-      layout: () => require('./src/components/Page/Page.jsx').default,
+    contribute: {
+      title: 'Contribute',
       url: ({ sectionName, fileName }) => `/${sectionName}/${fileName}/`,
-      content: () => require.context('./loaders/page-loader!./src/content/guides', false, /^\.\/.*\.md$/),
-      transform: (pages) => {
-        return _.sortBy(pages, (page) => page.file.sort)
-      },
+      layout: () => require('./src/components/Page/Page.jsx').default,
+      content: () => require.context('./loaders/page-loader!./src/content/contribute', false, /^\.\/.*\.md$/),
+    },
+    vote: () => require('./src/components/Vote/Vote.jsx').default,
+    organization: () => require('./src/components/Organization/Organization.jsx').default,
+    'starter-kits': () => require('./src/components/StarterKits/StarterKits.jsx').default,
+
+    /*************************
+     Redirects for Old Content
+     *************************/
+    'get-started': {
+      hidden: true,
       redirects: {
-        'code-splitting-import': '/guides/code-splitting',
-        'code-splitting-require': '/guides/code-splitting',
-        'code-splitting-async': '/guides/code-splitting',
-        'code-splitting-css': '/guides/code-splitting',
-        'code-splitting-libraries': '/guides/code-splitting',
-        'why-webpack': '/comparison',
-        'production-build': '/guides/production'
+        '': '/guides/getting-started',
+        'install-webpack': '/guides/installation',
+        'why-webpack': '/guides/why-webpack',
       }
     },
-    configuration: {
-      title: "Configuration",
-      layout: () => require('./src/components/Page/Page.jsx').default,
-      url: ({ sectionName, fileName }) => `/${sectionName}/${fileName}/`,
-      content: () => require.context('./loaders/page-loader!./src/content/configuration', false, /^\.\/.*\.md$/),
-      transform: (pages) => {
-        return _.sortBy(pages, (page) => page.file.sort)
+    pluginsapi: {
+      hidden: true,
+      redirects: {
+        '': '/api/plugins',
+        'compiler': '/api/compiler',
+        'template': '/api/template'
       }
     },
-    support: {
-      title: "Support",
-      layout: () => require('./src/components/Page/Page.jsx').default,
-      url: ({ sectionName, fileName }) => `/${sectionName}/${fileName}/`,
-      content: () => require.context('./loaders/page-loader!./src/content/support', false, /^\.\/.*\.md$/),
-      transform: (pages) => {
-        return _.sortBy(pages, (page) => page.file.sort)
+    'api/plugins': {
+      redirects: {
+        'compiler': '/api/compiler',
+        'compilation': '/api/compilation',
+        'module-factories': '/api/module-factories',
+        'parser': '/api/parser',
+        'tapable': '/api/tapable',
+        'template': '/api/template',
+        'resolver': '/api/resolver'
       }
     },
-    vote: () => {
-      const page = require('./src/components/Vote/List.jsx').default;
-      page.title = 'Vote';
-
-      return page;
-    },
-    organization: () => {
-      const page = require('./src/components/Organization/Organization.jsx').default;
-
-      page.title = 'Organization';
-
-      return page;
-    },
-    'guides/starter-kits': () => {
-      const page = require('./src/components/StarterKits/StarterKits.jsx').default;
-
-      page.title = 'Starter kits';
-
-      return page;
+    development: {
+      redirects: {
+        '': '/contribute',
+        'plugin-patterns': '/contribute/plugin-patterns',
+        'release-process': '/contribute/release-process',
+        'how-to-write-a-loader': '/contribute/writing-a-loader',
+        'how-to-write-a-plugin': '/contribute/writing-a-plugin'
+      }
     }
   }
 };

loaders/page-loader.js

@@ -8,6 +8,7 @@ module.exports = function (source) {
   const result = frontmatter(source);
 
   result.attributes = result.attributes || {};
+  result.attributes.group = result.attributes.group || '-';
   result.attributes.anchors = markdown().getAnchors(result.body);
   result.attributes.contributors = (result.attributes.contributors || []).sort();
   result.attributes.related = Array.isArray(result.attributes.related) ? result.attributes.related : [];

src/components/Footer/Footer.jsx

@@ -12,7 +12,7 @@ const Footer = () => (
       <section className="footer__left">
         <Link className="footer__link" to="/guides/getting-started/">Get Started</Link>
         <Link className="footer__link" to="/organization/">Organization</Link>
-        <Link className="footer__link" to="/support/">Support</Link>
+        <Link className="footer__link" to="/starter-kits/">Starter Kits</Link>
         <Link className="footer__link" to="/comparison/">Comparison</Link>
       </section>
 

src/components/Navigation/Links.json

@@ -0,0 +1,22 @@
+[
+  {
+    "title": "Documentation",
+    "url": "concepts",
+    "children": [
+      { "title": "Concepts", "url": "concepts" },
+      { "title": "Configuration", "url": "configuration" },
+      { "title": "API", "url": "api" },
+      { "title": "Guides", "url": "guides" },
+      { "title": "Loaders", "url": "loaders" },
+      { "title": "Plugins", "url": "plugins" }
+    ]
+  },
+  {
+    "title": "Contribute",
+    "url": "contribute"
+  },
+  {
+    "title": "Blog",
+    "url": "//medium.com/webpack"
+  }
+]