Fixing (hopefully) all three.js documentation links

[AndrewRayCode]

Addresses issue #175

Here's how this was done:

First I extracted all links using Ack and Vim, and removed duplicates using :sort u in Vim.

Through sheer luck I found all three.js doc pages load https://threejs.org/docs/list.js, which lists all relative doc paths, excluding method links.

Then I wrote a node script to compare all links found in the R3R project to the links from the above mentioned list.js. That script is found here

If you run this script with node test-r3r-links.js, it will not error. The assert on the last line is what verifies all links in R3R source exist in three.js's list.js index.

NOTE: I DID NOT HAND VERIFY THE METHOD SPECIFIC LINKS. As in, I know https://threejs.org/docs/#api/extras/core/Path is correct, but I did not hand verify all the method links like https://threejs.org/docs/#api/extras/core/Path.absarc

The actual change to the codebase took several search and replace sweeps in Visual Studio Code. It was made easier by the fact that the original doc links in R3R link to http, while the updated three docs all redirect to https.

Fun facts:

• This was not a simple search and replace. Some things moved, for example Extras.Geometries moved to api/core/geometries
• There were some links accidentally to index.html#/api which required specific hand hold replacing
• New doc links have lowercase, /materials/ vs /Materials/
• I considered making a quick scraper to make sure all replaced links were valid, but because threejs uses iframes, all broken links return 200s :shrug:
• Going to the actual doc page in the iframes redirect to broken URLs. For example, try going to https://threejs.org/docs/api/textures/Texture :shrug:
• Stop linking to things :D

[toxicFork]

Sweet! Thanks!! I'll verify and merge ASAP!

Stop linking to things :D

😅

[ashl1]

Any updates on this? Merging the PR will improve docs expirience for the react-three-render novices.

[toxicFork]

Thanks a lot again for the PR :)