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

[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 time will not work unless everything is in a completely flat directory structure, which will be unmaintainable. So I decided to go with a multi-page solution.

I have pushed the current work to a personal repo on GitHub. You can checkout the result at: 
https://bjornblissing.github.io/openscenegraph-tutorials

And the corresponding repo is here:
https://github.com/bjornblissing/openscenegraph-tutorials

So far I have built a test skeleton for tutorials. This includes a draft version of the table of contents and simple introduction tutorial to see if my test is working. I have included a CMakeList.txt file in the root directory which can be used to generate build files for the tutorials. 

The only available tutorial as of now is "Basic Geometry".

But before I continue with any more work I would like some community feedback. There are many questions that I think should be answered:

* Is this a tutorial format worth pursuing? 
* Is Markdeep the right choice?
* Is CCBY and MIT licenses that should be used for this project?
* What C++ standard should the source code be written in (my suggestion is C++98 for maximum compatibility)?

Note: This should not be seen as anything more than a very rough draft of how tutorials on GitHub pages could look like. If the community agrees that this is the way forward I will continue the work, as well as transfer the repository to the main OpenSceneGraph GitHub account. 

Regards,
Björn

------------------
Read this topic online here:
http://forum.openscenegraph.org/viewtopic.php?p=72416#72416