docs(api.pug): change to redirect to mongoose API page

docs/api.pug

@@ -2,66 +2,8 @@ extends layout
 
 append style
   link(rel="stylesheet", href="/docs/css/api.css")
-  script(src="/docs/js/api-bold-current-nav.js")
+  script(src="/docs/js/redirect-old-api.js")
 
 block content
-  h1 API Docs
-
-  include includes/native
-
-  div.api-nav
-    div.api-nav-content
-      each item in docs
-        - if (!item.hideFromNav)
-          div.nav-item(id='nav-' + item.name)
-            div.nav-item-title
-              a(href='./api/' + item.name.toLowerCase() + '.html')
-                | #{item.name}
-            ul.nav-item-sub
-              each prop in item.props
-                li
-                  a(href='./api/' + item.name.toLowerCase() + '.html#' + prop.anchorId)
-                    | #{prop.string}
-
-  each item in docs
-    hr.separate-api
-    div.item-header-wrap
-      <a class="edit-docs-link" href="#{item.editLink}" target="_blank">
-        <img src="/docs/images/pencil.svg" />
-      </a>
-      h2(id=item.name, class="item-header")
-        a(href='#' + item.name)
-          | #{item.name}
-    ul
-      each prop in item.props
-        li
-          a(href='#' + prop.anchorId)
-            | #{prop.string}
-    each prop in item.props
-      hr.separate-api-elements
-      h3(id=prop.anchorId)
-        a(href='#' + prop.anchorId)
-          | #{prop.string}
-      if prop.param != null
-        h5 Parameters
-        ul.params
-          each param in prop.param
-            - if (param.nested)
-              ul(style="margin-top: 0.5em")
-                li
-                  | #{param.name}
-                  | <span class="method-type">&laquo;#{param.types}&raquo;</span> !{param.description}
-            - else
-              li.param
-                | #{param.name}
-                | <span class="method-type">&laquo;#{param.types}&raquo;</span> !{param.description}
-      if prop.return != null
-        h5 Returns:
-        ul
-          li <span class="method-type">&laquo;#{prop.return.types}&raquo;</span> !{prop.return.description}
-      if prop.type != null && prop.type !== 'method' && prop.type !== 'function'
-        h5 Type:
-        ul
-          li <span class="method-type">&laquo;#{prop.type}&raquo;</span>
-      div
-        | !{prop.description}
+  p Redirecting to proper API page, please wait
+  noscript This Page requires JavaScript to Redirect old links properly

docs/includes/nav.pug

@@ -84,7 +84,7 @@ ul
           a(href="https://github.com/Automattic/mongoose/wiki/4.0-Release-Notes")
             | 4.0 release notes
   li.api
-    a(href="./api.html") API docs
+    a(href="./api/mongoose.html") API docs
   li.quickstart
     a(href="./index.html") quick start
   li.contrib

docs/js/redirect-old-api.js

@@ -0,0 +1,29 @@
+window.addEventListener('DOMContentLoaded', () => {
+    const anchor = window.location.hash;
+
+    // in case there is not anchor
+    if (!anchor) {
+        return redirectToBase();
+    }
+
+    const firstName = anchor.split('_')[0];
+
+    // in case there is no split
+    if (!firstName) {
+        return redirectToBase();
+    }
+
+    const sliced = firstName.slice(1).toLowerCase(); // ignore first character, which will always be "#"
+
+    // in case everything after "#" is empty
+    if (!sliced) {
+        return redirectToBase();
+    }
+
+    window.location.replace('./api/' + sliced + '.html' + anchor);
+}, { once: true });
+
+// helper function to redirect in case no other redirect can be found
+function redirectToBase() {
+    window.location.replace('./api/mongoose.html');
+}

docs/layout.pug

@@ -118,7 +118,7 @@ html(lang='en')
                 li.pure-menu-item.tertiary-item
                   a.pure-menu-link(href="/docs/typescript/subdocuments.html", class=outputUrl === '/docs/typescript/subdocuments.html' ? 'selected' : '') Subdocuments
               li.pure-menu-item
-                a.pure-menu-link(href="/docs/api.html", class=outputUrl === '/docs/api.html' ? 'selected' : '') API
+                a.pure-menu-link(href="/docs/api/mongoose.html", class=outputUrl === '/docs/api/mongoose.html' ? 'selected' : '') API
               li.pure-menu-item.sub-item
                 a.pure-menu-link(href="/docs/api/mongoose.html", class=outputUrl === '/docs/api/mongoose.html' ? 'selected' : '') Mongoose
               li.pure-menu-item.sub-item

docs/source/api.js

@@ -39,14 +39,7 @@ const files = [
   'lib/types/map.js'
 ];
 
-module.exports = {
-  docs: [],
-  github: 'https://github.com/Automattic/mongoose/blob/',
-  title: 'API docs',
-  api: true
-};
-
-const out = module.exports.docs;
+const out = module.exports.docs = [];
 
 const combinedFiles = [];
 for (const file of files) {

docs/source/index.js

@@ -11,7 +11,10 @@ try {
 } catch (err) {}
 
 exports['index.pug'] = require('./home');
-exports['docs/api.pug'] = require('./api');
+exports['docs/api.pug'] = {
+  docs: [],
+  title: 'Redirect to API',
+};
 
 exports['docs/advanced_schemas.md'] = { title: 'Advanced Schemas', acquit: true, markdown: true };
 exports['docs/validation.md'] = { title: 'Validation', acquit: true, markdown: true };