<p dir="auto">All doc links reference <code class="notranslate">window.parent.goTo</code> which has possibly never worked(?)</p>
<p dir="auto">First commit referencing <code class="notranslate">window.parent.goTo</code> by <a class="user-mention notranslate" data-hovercard-type="user" data-hovercard-url="/users/mrdoob/hovercard" data-octo-click="hovercard-link-click" data-octo-dimensions="link_type:self" href="https://github.com/mrdoob">@mrdoob</a> on July 24th, 2012 <code class="notranslate">git show -p 9a1bd006143e7d949d4b21804d28ccf80db701c1 -- docs/page.js</code></p>
<div class="snippet-clipboard-content notranslate position-relative overflow-auto" data-snippet-clipboard-copy-content="commit 9a1bd006143e7d949d4b21804d28ccf80db701c1
Author: Mr.doob &lt;info@mrdoob.com&gt;
Date:   Tue Jul 24 18:01:05 2012 +0200

    Refactored documentation system. No more XMLHttpRequest.
    Now you can browse the docs from the local system too."><pre class="notranslate"><code class="notranslate">commit 9a1bd006143e7d949d4b21804d28ccf80db701c1
Author: Mr.doob &lt;info@mrdoob.com&gt;
Date:   Tue Jul 24 18:01:05 2012 +0200

    Refactored documentation system. No more XMLHttpRequest.
    Now you can browse the docs from the local system too.
</code></pre></div>
<p dir="auto">Altered by <a class="user-mention notranslate" data-hovercard-type="user" data-hovercard-url="/users/alteredq/hovercard" data-octo-click="hovercard-link-click" data-octo-dimensions="link_type:self" href="https://github.com/alteredq">@alteredq</a> on Aug 8th 2012 <code class="notranslate">git show -p a650f50aa9ccb66e00d29d2efcbf31d6f13540fa</code></p>
<div class="snippet-clipboard-content notranslate position-relative overflow-auto" data-snippet-clipboard-copy-content="commit a650f50aa9ccb66e00d29d2efcbf31d6f13540fa
Author: alteredq &lt;postfilter@gmail.com&gt;
Date:   Wed Aug 8 17:49:40 2012 +0200

    Fixed bug in docs regular expression.

    This was creating mess when URL contained &quot;html&quot; also elsewhere than just at the end."><pre class="notranslate"><code class="notranslate">commit a650f50aa9ccb66e00d29d2efcbf31d6f13540fa
Author: alteredq &lt;postfilter@gmail.com&gt;
Date:   Wed Aug 8 17:49:40 2012 +0200

    Fixed bug in docs regular expression.

    This was creating mess when URL contained "html" also elsewhere than just at the end.
</code></pre></div>
<p dir="auto">Up next is <a class="user-mention notranslate" data-hovercard-type="user" data-hovercard-url="/users/caseygrun/hovercard" data-octo-click="hovercard-link-click" data-octo-dimensions="link_type:self" href="https://github.com/caseygrun">@caseygrun</a> <code class="notranslate">git log -p -- docs/page.js --author=Casey Grun</code> who made a bunch of commits to the docs file. This is a likely culprit because of multiple commits to address the same thing.</p>
<div class="snippet-clipboard-content notranslate position-relative overflow-auto" data-snippet-clipboard-copy-content="commit 5ddb3b7427f293eae8dedd496b1318ea42ea41b7
Author: Casey Grun &lt;casey.grun@gmail.com&gt;
Date:   Wed Oct 15 00:14:18 2014 -0400

    AlImprove member cross-linking functions in docs

...etc"><pre class="notranslate"><code class="notranslate">commit 5ddb3b7427f293eae8dedd496b1318ea42ea41b7
Author: Casey Grun &lt;casey.grun@gmail.com&gt;
Date:   Wed Oct 15 00:14:18 2014 -0400

    AlImprove member cross-linking functions in docs

...etc
</code></pre></div>
<p dir="auto">Whodunit? :D</p>
<p dir="auto">I don't know what the problem is because on the docs pages, <code class="notranslate">window.parent.goTo</code> is defined.</p>
<p dir="auto">I actually don't know if the doc method linking <em>ever</em> worked? I'm also not sure why we don't just use <code class="notranslate">&lt;a href="#anchor"&gt;</code> which is the standard way to link to anchors on a page.</p>
<p dir="auto">I've been looking at contributing documentation changes and noticed that there are some inconsistencies with the return value of methods.</p>
<p dir="auto">For example, <a href="http://threejs.org/docs/#Reference/Math/Vector3" rel="nofollow">Vector3's page</a> has a <code class="notranslate">this</code> after all methods that modify the <code class="notranslate">Vector3</code> in place and then return the same <code class="notranslate">Vector3</code>. But there are methods like <a href="http://threejs.org/docs/#Reference/Math/Vector3.distanceToSquared" rel="nofollow"><code class="notranslate">.distanceToSquared()</code></a> that have no return value after the method.</p>
<p dir="auto">So my questions are:</p>
<ol dir="auto">
<li>When should a return value follow a method definition?</li>
<li>When should that return value text be <code class="notranslate">this</code> or the type, eg. <code class="notranslate">Vector3</code>?</li>
</ol>
<p dir="auto"><em>Side Note:</em> There are methods that link to non-existent pages because their return type is a standard JS type ( eg. Boolean, Float, etc ). This is confusing if you are expecting to be redirected to the page on that type.</p>