BabylonJS / OldDocumentationSite

Babylon.js documentation page
http://doc.babylonjs.com
Apache License 2.0
66 stars 188 forks source link

There are 89 broken links in the documentation site #1998

Closed Jarred-Sumner closed 4 years ago

Jarred-Sumner commented 4 years ago

You all put so much effort into writing very helpful documentation but when the links are 404'ing, it makes it harder to find them :(

Rather than report them one-off, I ran a script to crawl doc.babylonjs.com for broken links:

blc https://doc.babylonjs.com/ -ro -e github -e .jpg -e .png -c 10 > broken-links-babylon.txt
grep -E '├─BROKEN─' broken-links-babylon.txt | sort | uniq

Here's the output after I cleaned it up a little:

https://doc.babylonjs.com/How_To/Animations#animation-blending
https://doc.babylonjs.com/How_To/Environment
https://doc.babylonjs.com/How_To/Normals
https://doc.babylonjs.com/How_To/Reflec#refractiont
https://doc.babylonjs.com/How_To/ShaderIntro
https://doc.babylonjs.com/How_To/Solid_Particle_System
https://doc.babylonjs.com/How_To/Using_the_Canvas2D
https://doc.babylonjs.com/How_To/environment#automatic-creation
https://doc.babylonjs.com/How_To/setup_visualStudio
https://doc.babylonjs.com/How_To/shadows
https://doc.babylonjs.com/advanced/Shader_Material.html
https://doc.babylonjs.com/api/classes/babylon.sceneloaderprogressevent
https://doc.babylonjs.com/api/classes/babylon.webxrcontroller
https://doc.babylonjs.com/babylon101/Environmentt#changing-the-background-color-sceneclearcolor
https://doc.babylonjs.com/babylon101/cascadedShadows
https://doc.babylonjs.com/extensions/Using_The_Canvas2D
https://doc.babylonjs.com/extensions/oceanpostprocess
https://doc.babylonjs.com/features/(/How_To/CreateBox_Per_Face_Textures_And_Colors
https://doc.babylonjs.com/features/Observables
https://doc.babylonjs.com/features/Using_The_Physics_Engine
https://doc.babylonjs.com/features/customize_debug_layer
https://doc.babylonjs.com/features/observables#multiobserver
https://doc.babylonjs.com/features/physically_based_rendering
https://doc.babylonjs.com/features/webvr_camera
https://doc.babylonjs.com/generals/File_Format_Map_(.babylon
https://doc.babylonjs.com/generals/Framework_versions
https://doc.babylonjs.com/how_To/Particles/Animate.md
https://doc.babylonjs.com/how_to/%22http:/localhost:1338/Playground/index-local.html%22
https://doc.babylonjs.com/how_to/%22http:/localhost:1338/inspector/index.html%22
https://doc.babylonjs.com/how_to/%22http:/localhost:1338/localDev/index.html%22
https://doc.babylonjs.com/how_to/%22http:/localhost:1338/materialsLibrary/index.html%22
https://doc.babylonjs.com/how_to/%22http:/localhost:1338/postProcessLibrary/index.html%22
https://doc.babylonjs.com/how_to/%22http:/localhost:1338/proceduralTexturesLibrary/index.html%22
https://doc.babylonjs.com/how_to/%22http:/localhost:1338/sandbox/index-local.html%22
https://doc.babylonjs.com/how_to/%22http:/localhost:1338/tests/validation/index.html%22
https://doc.babylonjs.com/how_to/WebXR_Controller_Support
https://doc.babylonjs.com/how_to/debug_layerEnable
https://doc.babylonjs.com/how_to/how%20to%20start%20contributing
https://doc.babylonjs.com/how_to/scene/Optimizing_your_scene#turning-adapttodeviceratio-offon
https://doc.babylonjs.com/how_to/several%20includes%20in%20Babylon
https://doc.babylonjs.com/how_to/solid_particle_system
https://doc.babylonjs.com/how_to/webxr
https://doc.babylonjs.com/img/extensions/dynamicTexture.jpg
https://doc.babylonjs.com/page.php?p=22081
https://doc.babylonjs.com/page.php?p=22531
https://doc.babylonjs.com/page.php?p=22581
https://doc.babylonjs.com/page.php?p=22591
https://doc.babylonjs.com/page.php?p=22601
https://doc.babylonjs.com/page.php?p=22611
https://doc.babylonjs.com/page.php?p=24822
https://doc.babylonjs.com/page.php?p=24824
https://doc.babylonjs.com/page.php?p=24825
https://doc.babylonjs.com/page.php?p=24827
https://doc.babylonjs.com/page.php?p=24828
https://doc.babylonjs.com/page.php?p=24829
https://doc.babylonjs.com/page.php?p=24830
https://doc.babylonjs.com/page.php?p=24831
https://doc.babylonjs.com/page.php?p=24832
https://doc.babylonjs.com/page.php?p=24833
https://doc.babylonjs.com/page.php?p=24834
https://doc.babylonjs.com/page.php?p=24837
https://doc.babylonjs.com/page.php?p=24840
https://doc.babylonjs.com/page.php?p=24841
https://doc.babylonjs.com/page.php?p=24847
https://doc.babylonjs.com/page.php?p=25088
https://doc.babylonjs.com/page.php?p=25090
https://doc.babylonjs.com/page.php?p=25091
https://doc.babylonjs.com/page.php?p=25094
https://doc.babylonjs.com/page.php?p=25096
https://doc.babylonjs.com/page.php?p=25109
https://doc.babylonjs.com/resources/Creating_Cinematic
https://doc.babylonjs.com/resources/Creating_Materials
https://doc.babylonjs.com/resources/Creating_Particle_Systems
https://doc.babylonjs.com/resources/File_Format_Map_(.babylon
https://doc.babylonjs.com/resources/Installing__the_Babylon_Exporter
https://doc.babylonjs.com/resources/Managin_Lens_Flare_Systems
https://doc.babylonjs.com/resources/Managing_Animations
https://doc.babylonjs.com/resources/Managing_Materials
https://doc.babylonjs.com/resources/PBT_Writing
https://doc.babylonjs.com/resources/PBT_previous_and_next
https://doc.babylonjs.com/resources/PBT_slider
https://doc.babylonjs.com/resources/Unity
https://doc.babylonjs.com/resources/Using_Actions_Builder
https://doc.babylonjs.com/resources/Using_Materials_Builder
https://doc.babylonjs.com/resources/Using_Post_Processes_Builder
https://doc.babylonjs.com/resources/[![image](https:/user-images.githubusercontent.com/954596/59141279-63c8f400-896f-11e9-9f2a-177b451f069f.png
https://doc.babylonjs.com/resources/hiding_editor_lines
https://doc.babylonjs.com/resources/how_to/how_to_use_gamepads
https://doc.babylonjs.com/resources/samples/OpenUrl
deltakosh commented 4 years ago

Hey this is fantastic

@PirateJC should be able to replace them! Feel free to send PR as well if you want to

Pinging @BabylonJSGuide as well

PirateJC commented 4 years ago

This is awesome! I'm going to dig into this now! Thank you @Jarred-Sumner

Jarred-Sumner commented 4 years ago

Np

Also worth flagging that many of the links pointing to demos don't work:

For example, in https://doc.babylonjs.com/how_to/optimizing_your_scene_with_octrees#Demos: image

PirateJC commented 4 years ago

Ok did a pass through and fixed links as well as removed a few old outdated ones.

https://github.com/BabylonJS/Documentation/pull/2011

Thanks again for pointing this out! We'll have to do another pass through to find broken demo links.