Introduction tutorial

[probins]

Suggestion for making a start on the tutorials. This is probably not complete (I shall probably remember things I've forgotten five minutes after submitting), but it can serve as a starting point.

I think tutorials should supplement what's in the api docs and examples, providing more detailed info on specific subjects. I would like to see more detailed tutorials on:

• event handling
• rendering process
• projection handling
• custom building

I can make a start on these, but I'm not an expert on the first two, so others would have to expand.

Not sure it's a good idea having these tutorials as hbs; not easy to read on Github.

[tschaub]

Thanks for getting a start on these @probins.

Not sure it's a good idea having these tutorials as hbs; not easy to read on Github.

Our first goal should be to have them render nicely on the ol3 website. I'd like to change how the website is built, and it may be that these will become .md files (still with YAML front matter). So they may become more readable on GitHub as well. But I don't think that should be a primary goal.

[probins]

I'd like to change how the website is built, and it may be that these will become .md files (still with YAML front matter). So they may become more readable on GitHub as well. But I don't think that should be a primary goal.

I've just been looking at the website repo, and AFAICS this should work with *.md files as is. There is no hbs markup in these tutorial files, so I don't see any need for them to be *.hbs. The layout pulls them in as md anyway. Let me know if you don't agree. Otherwise I'll change this tutorial to .md

[probins]

ok, I set up the current website repo, and ran assemble with tutorials named *.md, and it works without problem. So I've renamed this tutorial .md.

ISTM this is better not only because it's readable on Github, but also from the point of view of separating content from presentation. What's in doc/ is 'raw' content; how that's presented on the website is up to the software in the website repo.

[probins]

added mention that lib intended for both desktop and mobile devices

[pagameba]

just read this through, very nice.

[marcjansen]

Let's get this in. Future PRs may add or change content. Thanks for your efforts, @probins