Re: [osg-users] Call for assistance: Migrating and updating tutorials

2017-11-20 Thread Björn Blissing
Hi Robert, My idea is that this could evolve into a large set of tutorials. Every header in the TOC would be a separate tutorial, responsible for teaching a osg concept. Each tutorial will have the one markup file containing the "lesson" and then the corresponding source code as separate

Re: [osg-users] Call for assistance: Migrating and updating tutorials

2017-11-20 Thread Robert Osfield
Hi Björn, Thanks for your efforts on the tutorials. I had a quick look at what you have done so far, but am not yet clear how you are thinking it might evolve. I noticed both .md and .html files, are both something that will be maintained? On 19 November 2017 at 21:18, Björn Blissing

Re: [osg-users] Call for assistance: Migrating and updating tutorials

2017-11-20 Thread Björn Blissing
As I said in my previous email. There is only one example tutorial right now. The first one in the basic category: "basic geometry" The rest is as you say only a TOC. I haven't checked readthedocs yet. It may be an option. But I like markdeep for its feature set. Regards Björn Den 20 nov.

Re: [osg-users] Call for assistance: Migrating and updating tutorials

2017-11-20 Thread michael kapelko
Hi. I can't see any tutorial. It's just a Table Of Contents. I guess at least one tutorial is necessary to evaluate navigation. As a side note, https://readthedocs.org/ hosts lots of docs with a nice navigation, so this might be an option. On 20 November 2017 at 00:18, Björn Blissing

Re: [osg-users] Call for assistance: Migrating and updating tutorials

2017-11-19 Thread Björn Blissing
Hi Robert et al, As said earlier, I have started to experiment with GitHub pages. I discovered that it was hard to support both single-page and multi-page documents using markdeep (since its limited support for included documents). So having a single-page and multi-page document at the same

Re: [osg-users] Call for assistance: Migrating and updating tutorials

2017-10-20 Thread Eon Strife
SMesserschmidt wrote: > Hi Eon, > Do you have issues with any of the tutorials inside the books? > The only structural changes I recall is the promotion of the > geode/drawable hierarchy and some changes regarding the callbacks. But > maybe Robert can shed some light on the potential breaking

Re: [osg-users] Call for assistance: Migrating and updating tutorials

2017-10-19 Thread Björn Blissing
robertosfield wrote: > > I don't have a problem with video tutorial's, but as you say if API's change > then videos need to be re-shot, but then other resources have to be redone > anyway.  If one can make vidoes in a lightweight way then the cost of videos > might not be too high. The

Re: [osg-users] Call for assistance: Migrating and updating tutorials

2017-10-19 Thread Sebastian Messerschmidt
Hi Eon, Hi, Slightly off-topic, I started learning and using OpenSceneGraph end of last year, by using OpenSceneGraph 3.0 Beginner's Guide and OpenSceneGraph 3 Cookbook as my tutorial sources. It has been 5 years since the books were published. It will be nice if there are updated version

Re: [osg-users] Call for assistance: Migrating and updating tutorials

2017-10-17 Thread Robert Osfield
Hi Björn, On 16 October 2017 at 18:34, Björn Blissing wrote: > First of all Michael Kapelko's tutorials looks amazing. He must spent a > lot of time producing these. One problem though is that they do not specify > any permissive license. Another problem is that they are

Re: [osg-users] Call for assistance: Migrating and updating tutorials

2017-10-16 Thread Björn Blissing
Hi, First of all Michael Kapelko's tutorials looks amazing. He must spent a lot of time producing these. One problem though is that they do not specify any permissive license. Another problem is that they are in video form and those are hard to change if anything needs changing (other than

Re: [osg-users] Call for assistance: Migrating and updating tutorials

2017-10-16 Thread Robert Osfield
Hi Guys, Using gihub to host tutorial makes a lot of sense. I'd be happy to create an OpenSceneGraphTutorial repository on the OpenSceneGraph github account and then grant write permission to those who would like to pitch in. I don't think the old tutorial on old OSG website would be a good

Re: [osg-users] Call for assistance: Migrating and updating tutorials

2017-10-16 Thread Björn Blissing
Chris Hanson wrote: > I like the idea, assuming we can link them to the main site without problems. > Well, I have little experience on integrating GitHub pages to other sites. Maybe there is a simple way to import github markdown documents that could be integrated into the main site.

Re: [osg-users] Call for assistance: Migrating and updating tutorials

2017-10-16 Thread Chris Hanson
I like the idea, assuming we can link them to the main site without problems. But it still means people need to set that up, and migrate/update the tutorials. And I'm not hearing much response on that. Come on people, this is something that significantly helps the community, that you yourself

Re: [osg-users] Call for assistance: Migrating and updating tutorials

2017-10-16 Thread Björn Blissing
Hi, One idea could be to move the tutorials section to GitHub. That is creating a new github repository under the OpenSceneGraph account. We already have the OpenSceneGraph-Data repo, why not create a OpenSceneGraph-Tutorials repo? Each tutorial gets its own folder, which stores both the