search

mrdoob / three.js

JavaScript 3D Library.
https://threejs.org/
MIT License
102.01k stars 35.33k forks source link

"Getting started" link on main page goes to bad example #4214

Closed Michael-Z-Freeman closed 10 years ago

Michael-Z-Freeman commented 10 years ago

Hello. I followed the "Creating a scene" in the docs which is nice, clear and simple. But the example linked from the main page is, in my opinion, badly written for a beginner. More so, it does not work on Chrome 31.0.1650.63; loaded the demo and it shows a black box.

WestLangley commented 10 years ago

But the example linked from the main page is, in my opinion, badly written for a beginner.

Please explain what you feel is "badly written".

Replace

<script src="https://rawgithub.com/mrdoob/three.js/master/build/three.js"></script>

with

<script src="http://threejs.org/build/three.js"></script>

It is better to download your own local copy, actually. And for production, use the minified version three.min.js.

mrdoob commented 10 years ago

But the example linked from the main page is, in my opinion, badly written for a beginner.

Well, that sure is not something the guy that spent the time writing the article would like to read... Try with some constructive criticism the next time.

Michael-Z-Freeman commented 10 years ago

Apologies for any offence caused. I should have been more verbose. I meant that, in my opinion, the guide in the docs, here - http://threejs.org/docs/#Manual/Introduction/Creating_a_scene - would be a better intro to have from the "getting started" link. The other one is OK, but I think the docs one is clearer and simpler. Pretty minor niggle really, but just something that might help show people new to three.js/WebGL how simple it is to get into.

mrdoob commented 10 years ago

Ah, sorry... I misunderstood. So you think that docs page is better? What do you think @WestLangley?

WestLangley commented 10 years ago

I think the docs page tutorial is very good! :-)

I would use it, instead.

I would encourage linking to a local version, however. And I'd emphasize that it is best to link to the non-minified version while learning. Link to the minified version for production.

WestLangley commented 10 years ago

Oops. I misunderstood. I thought the issue was with the Usage example on this page: https://github.com/mrdoob/three.js -- not with the @aerotwist article. Sorry.