chore(doc): fix edit links for reference API (#2303)

* chore(doc): edit this page links now points to develop

This might not be in sync with the current content but those will be the
current next version.

* chore(doc): fix edit links for reference API

The script was assuming the name of the repo would be `instantsearch.js`
which might be an issue if the name of the folder is different.

Also refactor the way we figure out the path of each file because there
was a discrepancy.

FIX #2301

docgen/layouts/archetypes/content-with-menu.pug

@@ -10,7 +10,7 @@ body.documentation
       a.sidebar-opener
       .documentation-container
         if(editable)
-          a.editThisPage(href=`http://github.com/algolia/instantsearch.js/edit/master/${githubSource}`) Edit this page
+          a.editThisPage(href=`http://github.com/algolia/instantsearch.js/edit/develop/${githubSource}`) Edit this page
         block content
 
   include ../common/footer.pug

docgen/plugins/documentationjs-data.js

@@ -1,8 +1,15 @@
+import path from 'path';
+
 import {uniqBy, forEach, reduce, groupBy, findIndex, find, filter, isArray, isObject} from 'lodash';
 import documentation from 'documentation';
 import remark from 'remark';
 import md from '../mdRenderer';
 
+const baseDir = path.resolve(process.cwd(), '..');
+function getGithubSource(symbol) {
+  return symbol.context.file.split(baseDir)[1].substring(1);
+}
+
 function formatMD(ast) {
   if (ast && ast.type === 'root') {
     // 1. extract the raw markdown string from the remark AST
@@ -82,8 +89,6 @@ function groupSymbolsByCategories(symbols) {
 function mapInstantSearch([instantsearchFactory, InstantSearch], symbols, files) {
   const fileName = 'instantsearch.html';
 
-  const githubSource = InstantSearch.context.file.split('instantsearch.js')[1];
-
   files[fileName] = {
     mode: '0764',
     contents: '',
@@ -101,7 +106,7 @@ function mapInstantSearch([instantsearchFactory, InstantSearch], symbols, files)
     },
     withHeadings: true,
     editable: true,
-    githubSource: githubSource,
+    githubSource: getGithubSource(InstantSearch),
   };
 }
 
@@ -114,9 +119,6 @@ function mapConnectors(connectors, symbols, files) {
       relatedTypes: findRelatedTypes(symbol, symbols),
     };
 
-    const githubSource = 'http://github.com/algolia/instantsearch.js/edit/master' +
-      symbolWithRelatedType.context.file.split('instantsearch.js')[1];
-
     files[fileName] = {
       mode: '0764',
       contents: '',
@@ -128,7 +130,7 @@ function mapConnectors(connectors, symbols, files) {
       jsdoc: symbolWithRelatedType,
       withHeadings: true,
       editable: true,
-      githubSource: githubSource,
+      githubSource: getGithubSource(symbolWithRelatedType),
     };
   });
 }
@@ -146,8 +148,6 @@ function mapWidgets(widgets, symbols, files) {
       relatedTypes,
     };
 
-    const githubSource = symbolWithRelatedType.context.file.split('instantsearch.js/')[1];
-
     files[fileName] = {
       mode: '0764',
       contents: '',
@@ -159,7 +159,7 @@ function mapWidgets(widgets, symbols, files) {
       jsdoc: symbolWithRelatedType,
       withHeadings: true,
       editable: true,
-      githubSource: githubSource,
+      githubSource: getGithubSource(symbolWithRelatedType),
     };
   });
 }