text: [{"Owner":"Temechon","Date":"2015-03-20T17:38:58Z","Content":"_lt_div class_eq__qt_mages_qt__gt_\n\t\t\t\n_lt_p_gt_Sorry_co_ it was a big week for me... First thing on Monday_co_ I sware !_lt_/p_gt_\n\n\n\t\t\t\n\t\t_lt_/div_gt_\n\n\t\t_lt_div class_eq__qt_ipsI_qt__gt__lt_/div_gt__lt_/div_gt_"},{"Owner":"RaananW","Date":"2015-03-20T21:19:21Z","Content":"_lt_div class_eq__qt_mages_qt__gt_\n\t\t\t\n_lt_p_gt_Hola people_co__lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt__lt_strike_gt_I have been having troubles logging in again - I am pretty sure the password I entered was correct_co_ but it still didn_t_t let me log in_co_ so I asked for a password reset. This password didn_t_t work as well  _lt_img src_eq__qt_http_dd_//www.html5gamedevs.com/uploads/emoticons/default_huh.png_qt_ alt_eq__qt__dd_huh_dd__qt__gt__lt_/strike_gt__lt_/p_gt__lt_p_gt__lt_strike_gt_any help is appreciated!_lt_/strike_gt__lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt__lt_img src_eq__qt_http_dd_//brickfanatics.co.uk/wp-content/uploads/2014/03/everythingisawesometee.jpg_qt_ alt_eq__qt_everythingisawesometee.jpg_qt__gt__lt_/p_gt_\n\n\n\t\t\t\n\t\t_lt_/div_gt_\n\n\t\t_lt_div class_eq__qt_ipsI_qt__gt__lt_/div_gt__lt_/div_gt_"},{"Owner":"Deltakosh","Date":"2015-03-21T02:34:26Z","Content":"_lt_div class_eq__qt_mages_qt__gt_\n\t\t\t\n_lt_p_gt_lol_lt_/p_gt_\n\n\n\t\t\t\n\t\t_lt_/div_gt_\n\n\t\t_lt_div class_eq__qt_ipsI_qt__gt__lt_/div_gt__lt_/div_gt_"},{"Owner":"Dad72","Date":"2015-03-24T11:31:49Z","Content":"_lt_div class_eq__qt_mages_qt__gt_\n\t\t\t\n_lt_p_gt_This seems fix. by cons I was wondering if it was possible to date versions (The 24/03/2015) of editing tutorials. Currently we have the person who edited_co_ but no date._lt_/p_gt_\n\n\n\t\t\t\n\t\t_lt_/div_gt_\n\n\t\t_lt_div class_eq__qt_ipsI_qt__gt__lt_/div_gt__lt_/div_gt_"},{"Owner":"jerome","Date":"2015-03-24T12:49:48Z","Content":"_lt_div class_eq__qt_mages_qt__gt_\n\t\t\t\n_lt_p_gt_Je plussoie._lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_+1_lt_/p_gt_\n\n\n\t\t\t\n\t\t_lt_/div_gt_\n\n\t\t_lt_div class_eq__qt_ipsI_qt__gt__lt_/div_gt__lt_/div_gt_"},{"Owner":"Temechon","Date":"2015-03-24T14:21:08Z","Content":"_lt_div class_eq__qt_mages_qt__gt_\n\t\t\t\n_lt_p_gt_Indeed_co_ it was fixed this morning. I will check for the date (I don_t_t know if it_t_s the data model or not _dd_/ )_lt_/p_gt_\n\n\n\t\t\t\n\t\t_lt_/div_gt_\n\n\t\t_lt_div class_eq__qt_ipsI_qt__gt__lt_/div_gt__lt_/div_gt_"},{"Owner":"jahow","Date":"2015-07-06T10:09:16Z","Content":"_lt_div class_eq__qt_mages_qt__gt_\n\t\t\t\n_lt_p_gt_Hey_co__lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_I_t_ve tried to find a nice place to put some more info on baking transform into meshes_co_ but I couldn_t_t find a really suitable page. Eventually I submitted some new stuff on the _t__lt_em_gt_How Rotations and Translations Work_t__lt_/em_gt_ page_co_ but I think changing its name to _lt_em_gt__t_Advanced Mesh Transforms_t__lt_/em_gt_ or something like might be better suited (especially since the stuff I added also deals with scaling)._lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_Just a suggestion!_lt_/p_gt_\n\n\n\t\t\t\n\t\t_lt_/div_gt_\n\n\t\t_lt_div class_eq__qt_ipsI_qt__gt__lt_/div_gt__lt_/div_gt_"},{"Owner":"Deltakosh","Date":"2015-07-06T13:36:28Z","Content":"_lt_div class_eq__qt_mages_qt__gt_\n\t\t\t\n_lt_p_gt_I like the current title because this is one of the first questions any newbie will have. And your article is the perfect content to answer it_dd_)_lt_/p_gt_\n\n\n\t\t\t\n\t\t_lt_/div_gt_\n\n\t\t_lt_div class_eq__qt_ipsI_qt__gt__lt_/div_gt__lt_/div_gt_"},{"Owner":"jahow","Date":"2015-07-06T13:49:39Z","Content":"_lt_div class_eq__qt_mages_qt__gt_\n\t\t\t\n_lt_p_gt_Alrighty! I figure that if anyone looks up _qt_baking_qt_ or _qt_bake_qt_ they will end up on this page anyhow _lt_img src_eq__qt_http_dd_//www.html5gamedevs.com/uploads/emoticons/default_smile.png_qt_ alt_eq__qt__dd_)_qt_ srcset_eq__qt_http_dd_//www.html5gamedevs.com/uploads/emoticons/smile@2x.png 2x_qt_ width_eq__qt_20_qt_ height_eq__qt_20_qt__gt__lt_/p_gt_\n\n\n\t\t\t\n\t\t_lt_/div_gt_\n\n\t\t_lt_div class_eq__qt_ipsI_qt__gt__lt_/div_gt__lt_/div_gt_"},{"Owner":"jahow","Date":"2015-07-24T07:53:06Z","Content":"_lt_div class_eq__qt_mages_qt__gt_\n\t\t\t\n_lt_p_gt_Hi! would it be possible to display a linked table of contents at the beginning of each article_co_ based on the titles used? Just like wikipedia does for example._lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_I think that would make a nice improvement to readability of the documentation (not that it_t_s currently lacking!)._lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_EDIT_dd_ apparently there_t_s a lib for it_dd_ _lt_a href_eq__qt_https_dd_//github.com/jonschlinkert/markdown-toc_qt_ rel_eq__qt_external nofollow_qt__gt_https_dd_//github.com/jonschlinkert/markdown-toc_lt_/a_gt__lt_/p_gt_\n\n\n\t\t\t\n\t\t_lt_/div_gt_\n\n\t\t_lt_div class_eq__qt_ipsI_qt__gt__lt_/div_gt__lt_/div_gt_"},{"Owner":"Temechon","Date":"2015-07-24T09:10:16Z","Content":"_lt_div class_eq__qt_mages_qt__gt_\n\t\t\t\n_lt_p_gt_Do you mean for article other than API classes ?_lt_/p_gt__lt_p_gt_I guess we can add this to our roundmap _lt_img src_eq__qt_http_dd_//www.html5gamedevs.com/uploads/emoticons/default_smile.png_qt_ alt_eq__qt__dd_)_qt_ srcset_eq__qt_http_dd_//www.html5gamedevs.com/uploads/emoticons/smile@2x.png 2x_qt_ width_eq__qt_20_qt_ height_eq__qt_20_qt__gt__lt_/p_gt_\n\n\n\t\t\t\n\t\t_lt_/div_gt_\n\n\t\t_lt_div class_eq__qt_ipsI_qt__gt__lt_/div_gt__lt_/div_gt_"},{"Owner":"jahow","Date":"2015-07-24T09:32:20Z","Content":"_lt_div class_eq__qt_mages_qt__gt_\n\t\t\t\n_lt_p_gt_Yes_co_ not for API classes and _qt_list_qt_ articles (containing all the child items)!_lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_I think it would be awesome._lt_/p_gt_\n\n\n\t\t\t\n\t\t_lt_/div_gt_\n\n\t\t_lt_div class_eq__qt_ipsI_qt__gt__lt_/div_gt__lt_/div_gt_"},{"Owner":"Temechon","Date":"2015-07-24T09:41:17Z","Content":"_lt_div class_eq__qt_mages_qt__gt_\n\t\t\t\n_lt_p_gt_No problem_co_ I add it to my backlog _lt_img src_eq__qt_http_dd_//www.html5gamedevs.com/uploads/emoticons/default_smile.png_qt_ alt_eq__qt__dd_)_qt_ srcset_eq__qt_http_dd_//www.html5gamedevs.com/uploads/emoticons/smile@2x.png 2x_qt_ width_eq__qt_20_qt_ height_eq__qt_20_qt__gt_ Thanks for the suggestion_co_ it_t_s always appreciated!_lt_/p_gt_\n\n\n\t\t\t\n\t\t_lt_/div_gt_\n\n\t\t_lt_div class_eq__qt_ipsI_qt__gt__lt_/div_gt__lt_/div_gt_"},{"Owner":"Wingnut","Date":"2015-07-24T14:19:56Z","Content":"_lt_div class_eq__qt_mages_qt__gt_\n\t\t\t\n_lt_p_gt_I_t_m a bit confused (normal).  If I may ask_co_ would this TOC be for things like the API doc for Scene_co_ and Mesh (big objects) where we now use in-browser search_co_ and thus get hits from the doc and_co_ unfortunately_co_ from the sidebar too?_lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_Are we talking about putting a substantial chunk of .md at the top of (some of) our .ts files?  Or_co_ would this TOC be _qt_generated_qt_ when the the .ts was converted to um... whatever its converted-to (html_co_ I think)?  (thx for clarification)_lt_/p_gt_\n\n\n\t\t\t\n\t\t_lt_/div_gt_\n\n\t\t_lt_div class_eq__qt_ipsI_qt__gt__lt_/div_gt__lt_/div_gt_"},{"Owner":"JCPalmer","Date":"2015-07-24T16:58:47Z","Content":"_lt_div class_eq__qt_mages_qt__gt_\n\t\t\t\n_lt_p_gt__lt_a class_eq__qt_ipsAttachLink ipsAttachLink_image_qt_ href_eq__qt_http_dd_//www.html5gamedevs.com/uploads/monthly_07_2015/post-8492-0-11929700-1437756730.png_qt_ rel_eq__qt_external nofollow_qt__gt__lt_img src_eq__qt_http_dd_//www.html5gamedevs.com/uploads/monthly_07_2015/post-8492-0-11929700-1437756730.png_qt_ data-fileid_eq__qt_4705_qt_ class_eq__qt_ipsImage ipsImage_thumbnailed_qt_ alt_eq__qt_post-8492-0-11929700-1437756730.png_qt__gt__lt_/a_gt_A Mark up question.  Is there a way to put text to the right of the image_co_ so that it not a huge vertical waste of space?_lt_/p_gt__lt_p_gt_It crudely works in forum posts._lt_/p_gt_\n\n\n\t\t\t\n\t\t_lt_/div_gt_\n\n\t\t_lt_div class_eq__qt_ipsI_qt__gt__lt_/div_gt__lt_/div_gt_"},{"Owner":"Wingnut","Date":"2015-07-25T13:30:26Z","Content":"_lt_div class_eq__qt_mages_qt__gt_\n\t\t\t\n_lt_p_gt__lt_a href_eq__qt_https_dd_//www.google.com/search?q_eq_floating+an+image+in+githgub+markdown&amp_sm_gws_rd_eq_ssl#q_eq_floating+an+image+in+github+markdown_qt_ rel_eq__qt_external nofollow_qt__gt_https_dd_//www.google.com/search?q_eq_floating+an+image+in+githgub+markdown&amp_sm_gws_rd_eq_ssl#q_eq_floating+an+image+in+github+markdown_lt_/a_gt__lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_*shrug*  Wish I could help in a better way_co_ but after I saw the search returns_co_ I figged it would be best if YOU toured them yourself.  In fact_co_ I_t_m going to read a few of them_co_ too.  I didn_t_t know there was such a thing as inline html with markdown... until today.  Interesting.  Hope this helps.  Thanks for all the great work you do_co_ Jc._lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_By the way everyone_co_ it is a demo picture_co_ and not pertinent to the subject.  _lt_img src_eq__qt_http_dd_//www.html5gamedevs.com/uploads/emoticons/default_smile.png_qt_ alt_eq__qt__dd_)_qt_ srcset_eq__qt_http_dd_//www.html5gamedevs.com/uploads/emoticons/smile@2x.png 2x_qt_ width_eq__qt_20_qt_ height_eq__qt_20_qt__gt_  I was confused at first_co_ but that_t_s normal for me.  I tried an image search for _qt_float image_qt_ to find a better demo picture for Jc_t_s post_co_ but I nearly drown in pictures of parades.  hah_lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_Are you working on v2 of your layermask/target reticle doc?   I recently adjusted this line... _qt_window size change_co_ unless it is a tablet app._qt_ (hope that is ok with you)  and I lightly suggest that _qt_may be more lights generated later_qt_ be changed to _qt_may be more lights _lt_u_gt_created_lt_/u_gt_ later_qt_.  Your call on that... just a thought._lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_Be sure to let me know if you want your name on that doc.  Again_co_ I hope you come on-board BD yourself_co_ but I_t_m here if you need things done_co_ there._lt_/p_gt_\n\n\n\t\t\t\n\t\t_lt_/div_gt_\n\n\t\t_lt_div class_eq__qt_ipsI_qt__gt__lt_/div_gt__lt_/div_gt_"},{"Owner":"jahow","Date":"2015-07-27T16:51:58Z","Content":"_lt_div class_eq__qt_mages_qt__gt_\n\t\t\t\n_lt_blockquote data-ipsquote_eq__qt__qt_ class_eq__qt_ipsQuote_qt_ data-ipsquote-contentcommentid_eq__qt_90305_qt_ data-ipsquote-contenttype_eq__qt_forums_qt_ data-ipsquote-contentclass_eq__qt_forums_Topic_qt_ data-ipsquote-contentid_eq__qt_11844_qt_ data-ipsquote-username_eq__qt_Wingnut_qt_ data-cite_eq__qt_Wingnut_qt_ data-ipsquote-timestamp_eq__qt_1437747596_qt__gt__lt_div_gt__lt_div_gt__lt_p_gt_I_t_m a bit confused (normal).  If I may ask_co_ would this TOC be for things like the API doc for Scene_co_ and Mesh (big objects) where we now use in-browser search_co_ and thus get hits from the doc and_co_ unfortunately_co_ from the sidebar too?_lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_Are we talking about putting a substantial chunk of .md at the top of (some of) our .ts files?  Or_co_ would this TOC be _qt_generated_qt_ when the the .ts was converted to um... whatever its converted-to (html_co_ I think)?  (thx for clarification)_lt_/p_gt__lt_/div_gt__lt_/div_gt__lt_/blockquote_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_Hey Wingnut_co__lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_What I had in mind was only a TOC in tutorial articles only_co_ not API docs. True_co_ the browser search is the perfect way when you know exactly what word you are looking for. In other cases (ie wandering aimlessly_co_ looking for answers)_co_ or if you want to give a link to an anchor in the article_co_ a TOC might come in handy._lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_Also the TOC would be generated at markdown interpretation (which I guess happens when the page is loaded)._lt_/p_gt_\n\n\n\t\t\t\n\t\t_lt_/div_gt_\n\n\t\t_lt_div class_eq__qt_ipsI_qt__gt__lt_/div_gt__lt_/div_gt_"},{"Owner":"Jaskar","Date":"2015-08-01T13:39:49Z","Content":"_lt_div class_eq__qt_mages_qt__gt_\n\t\t\t\n_lt_div_gt_Hi Wingnut_co_ Jahow_co_ and other Babylonians  _lt_img src_eq__qt_http_dd_//www.html5gamedevs.com/uploads/emoticons/default_smile.png_qt_ alt_eq__qt__dd_)_qt_ srcset_eq__qt_http_dd_//www.html5gamedevs.com/uploads/emoticons/smile@2x.png 2x_qt_ width_eq__qt_20_qt_ height_eq__qt_20_qt__gt__lt_/div_gt__lt_br_gt__lt_div_gt_ _lt_/div_gt__lt_br_gt__lt_div_gt_To be clear_co_ the TOC is present only on tutorials / extensions / exporters documentation._lt_/div_gt__lt_br_gt__lt_div_gt_In classes doc_co_ there is a dropdown list to jump directly to a member / function of the class._lt_/div_gt__lt_br_gt__lt_div_gt_ _lt_/div_gt__lt_br_gt__lt_div_gt_This TOC is generated from the markdown file. So_co_ there will be a tutorial about _qt_How to properly write a tutorial_qt_ to correctly generate this TOC._lt_/div_gt__lt_br_gt__lt_div_gt_ _lt_/div_gt__lt_br_gt__lt_div_gt_Hope I was clear! Else_co_ you can ask Temechon  _lt_img src_eq__qt_http_dd_//www.html5gamedevs.com/uploads/emoticons/default_tongue.png_qt_ alt_eq__qt__dd_P_qt_ srcset_eq__qt_http_dd_//www.html5gamedevs.com/uploads/emoticons/tongue@2x.png 2x_qt_ width_eq__qt_20_qt_ height_eq__qt_20_qt__gt__lt_/div_gt__lt_br_gt_\n\n\t\t\t\n\t\t_lt_/div_gt_\n\n\t\t_lt_div class_eq__qt_ipsI_qt__gt__lt_/div_gt__lt_/div_gt_"},{"Owner":"Wingnut","Date":"2015-08-03T12:02:15Z","Content":"_lt_div class_eq__qt_mages_qt__gt_\n\t\t\t\n_lt_p_gt_Thanks guys!  Great comments!  Thanks for the clarifications. _lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_Boy_co_ do we need that drop-down list thing_co_ especially on Scene class.  Scene class doc is well longer than any tutorial-type document we have. _lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_Cameras is one of our longest tutorial-class docs_co_ and there_t_s been some talk about splitting that into separate files.  Two of our cameras already have files specific to them._lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_When our playpen tutorials were first written_co_ they were sequenced.  In a true tutorial fashion_co_ each document talked users through adding ANOTHER cool thing to an on-going scene build.  In other words_co_ about 15 tutorials were really part of a single scene-building tutorial.  Essentially_co_ it was a beginner-level _qt_convincing scene_qt_ tutorial_co_ segmented into step-by-step.  At the end_co_ users got a single scene with all the basics_co_ and some advanced scene features. _lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_As our documentation grew_co_ and as we started using playground scenes to show each step... it was clear that we could _lt_u_gt_not_lt_/u_gt_ have all these features running in a demo all at once. Each playground demo that was associated with each step of the playpen tutorials... needed to be very clear and ONLY show THAT step.  In other words_co_ we couldn_t_t have a playground near the end of the playpen series... that showed sprites_co_ particles_co_ materials_co_ basic/advanced shapes_co_ fog_co_ skyboxes_co_ etc... all in the same scene.  It got too cluttered._lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_So_co_ about that time_co_ I made an audacious command decision.... to phase-out the step-by-step sequential format of the playpen tutorials.  I used The Babylon Primer as the step-by-step to get a basic scene activated (as best I could)_co_ and I evolved the playpen series into a non-sequential thing.  The Primer replaced playpen docs 1 and 2_co_ which likely nobody remembers.  Then I started with playpen #3... renumbered_co_ and matched those numbers to playground demo numbers.  You will still notice a few _qt_now your scene is looking great...blah blah blah_qt_... residuals from the sequential step-by-step days._lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_All of a sudden (actually only about 5/8 of a sudden)... the definition of _qt_tutorial_qt_ was in question_co_ at least in MY mind.  A TRUE tutorial_co_ in my opinion_co_ is ALWAYS a talk-through_co_ and therefore a TOC is inappropriate.  A TOC would allow people to enter these talk-throughs at middle points... ruining the _qt_talk-through/walk-through_qt_ sequence._lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_But then_co_ _qt_tutorials_qt_ like Cameras came along.   With 8-10 cameras covered in that document... it sure couldn_t_t be in _qt_talk-through_qt_ format any more_co_ if it ever was.  The Cameras tutorial/documentation seemed to say goodbye to being a true tutorial_co_ and became a _qt_documentation_qt_ or whatever you want to call a non-tutorial teaching file.  It became a _qt_Everything You Ever Wanted to Know About Cameras_qt_.  I think it is useful in its current format_co_ but_co_ it_t_s not really a tutorial_co_ and it_t_s also not _qt_Everything About Cameras_qt_.  IF we included everything about cameras_co_ then the document would get much longer_co_ and... it would need a TOC or need separating into 1-file-per-camera._lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_Yuh yuh yuh_co_ there_t_s issues.  I_t_ve had ideas_co_ but my best ideas require XSL and XML_co_ and require saying goodbye to .md (github markdown).  I_t_ve never been happy with markdown.  Poor formatting options_co_ no color coding_co_ no XSL filtering_co_ it_t_s just garbage (imho)_co_ and long ago outdated.  _lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_But_co_ it IS easier for a _qt_many editors_qt_ system like our BabylonDoc system.  If we allowed many folks to edit our potential future XML and XSL tutorials_co_ I think we_t_d have messes... but maybe we would come to each others_t_ rescue to repair them.  With XSL_co_ we can let users choose the filtering levels.... by letting them choose different XSL stylesheets to apply against the XML_co_ or even letting users write and store their own XSL stylesheets... and have personalized document filtering... including rendering the document to look like a Table Of Contents (TOC).  And_co_ with styled XML_co_ we get anchor points... for TOC_t_s.  Conversely_co_ I_t_m not sure if .md allows anchors at all._lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_In my opinion_co_ Scene and Mesh API docs... need TOC_t_s more than any other docs we have.  It takes me forever to find something I need on Scene_co_ and when I get there_co_ I get VERY SPARSE info from the .ts files... rarely any help whatsoever.  I usually need to go to the Scene source code at GitHub_co_ and try to determine what a Scene property/method really does... via analyzing the code.  That_t_s not good._lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_Ahh_co_ SO much to think about.  Lots of opinions and ideas.  How do we know what_t_s right and what_t_s not so right?  Should we start by putting strict regimentation on the terminology?  Should our _qt_tutorials_qt_ follow the strict definition of a _qt_tutorial_qt_?  Do we care about that?  I once mentioned it to Temechon_co_ too_co_ when trying to determine if _qt_tutorials_qt_ should have one type of icon_co_ and _qt_documentation_qt_ another type... etc.  In other words... for Temechon and BD programmers_co_ should tutorials be ONE type of PHP class_co_ and documentation be another type_co_ and API doc be a third type?  Should we try to strictly conform to our document types?  Do we try to teach our curators and editors how to avoid adding things to tutorials... which don_t_t follow the _qt_rules of being a tutorial_qt_?  Why do I start feeling Gestapo_co_ suddenly?  _lt_img src_eq__qt_http_dd_//www.html5gamedevs.com/uploads/emoticons/default_smile.png_qt_ alt_eq__qt__dd_)_qt_ srcset_eq__qt_http_dd_//www.html5gamedevs.com/uploads/emoticons/smile@2x.png 2x_qt_ width_eq__qt_20_qt_ height_eq__qt_20_qt__gt__lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_My brain hurts.  Comments welcome... but... I think we_t_re not yet ready to begin BabylonDocs 2.  That_t_s why I was surprised to hear that folks were already working on it.  I don_t_t think its requirements have been ironed-out_co_ yet.  I don_t_t think we have addressed the limitations of .md.  And_co_ we have a decision-by-committee situation at hand_co_ which is loving and considerate and democratic_co_ but takes forever and is like extracting teeth with a Jello cube.  _lt_img src_eq__qt_http_dd_//www.html5gamedevs.com/uploads/emoticons/default_biggrin.png_qt_ alt_eq__qt__dd_D_qt_ srcset_eq__qt_http_dd_//www.html5gamedevs.com/uploads/emoticons/biggrin@2x.png 2x_qt_ width_eq__qt_20_qt_ height_eq__qt_20_qt__gt__lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_Thoughts?  (Wingy ducks and covers).  heh.  By the way_co_ I_t_m quite sure that Jaskar is a member of the BD2 dev team (in case some of our readers don_t_t know that).  Thanks for the status reports_co_ Jaskar... keep them coming when you get a chance_co_ eh?  Cool._lt_/p_gt_\n\n\n\t\t\t\n\t\t_lt_/div_gt_\n\n\t\t_lt_div class_eq__qt_ipsI_qt__gt__lt_/div_gt__lt_/div_gt_"},{"Owner":"jahow","Date":"2015-08-03T17:34:16Z","Content":"_lt_div class_eq__qt_mages_qt__gt_\n\t\t\t\n_lt_p_gt_Thanks Jaskar_co_ this sounds good!_lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_Wingnut_co_ I think your point on tutorials not being actual tutorials is right on. It_t_s easy to tell when you see the BJS docs that they have been steadily growing and expanding along with the framework. As a contributor of a few lines here and there in the doc_co_ I can tell that I had a hard time finding the right place to document features about 75% of the time. I_t_d say (probably an uneducated guess) that one day or another the whole structure of the documentation will have to be rethinked_co_ and files will have to be merged/splitted accordingly (tutorials on one side_co_ helping building a simple scene step by step_co_ and documentation/advanced features articles on the other side). Maybe that_t_s already happening behind the scenes for BabylonDoc 2.0?_lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_Also_co_ 100% agreed on having to look into the source to know what a property does. I for one don_t_t use the API pages in the documentation as the source code is very readable_co_ especially TS files. Not ranting here_co_ I_t_m just giving as much feedback as possible!_lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_On the other hand_co_ I don_t_t agree with your view on markdown. In my opinion_co_ markdown is a great tool for authoring formatted text_co_ as it has no real syntax to speak of_co_ is very widely used and just simple to work with. Really_co_ when writing documentation_co_ no one should have to worry about styling or syntax. Even more_co_ no one should be able to break the consistency of the whole documentation by altering the styling of one specific article._lt_/p_gt_\n\n\n\t\t\t\n\t\t_lt_/div_gt_\n\n\t\t_lt_div class_eq__qt_ipsI_qt__gt__lt_/div_gt__lt_/div_gt_"},{"Owner":"Deltakosh","Date":"2015-08-03T19:13:09Z","Content":"_lt_div class_eq__qt_mages_qt__gt_\n\t\t\t\n_lt_p_gt_Completely agree on the markdown stuff_lt_/p_gt_\n\n\n\t\t\t\n\t\t_lt_/div_gt_\n\n\t\t_lt_div class_eq__qt_ipsI_qt__gt__lt_/div_gt__lt_/div_gt_"},{"Owner":"Wingnut","Date":"2015-08-03T22:10:26Z","Content":"_lt_div class_eq__qt_mages_qt__gt_\n\t\t\t\n_lt_p_gt_Who do you agree with_co_ DK?  We have some docs in html at msdn (almost all of our mid-levels)_co_ and some docs in markdown at BD.  Is anyone hurrying to convert the one-person-editable html docs at msdn_co_ into multi-person-editable markdown docs at BD? _lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_No.  Why?  Because nobody is in a hurry to degrade the msdn docs_co_ right?   Why format for modern browsers when we can format for Lynx? (sarcasm).  (Boy_co_ I_t_m old.  For those under 40 yrs old_co_ Lynx was the Model - A of browsers.  It was about as intelligent as a markdown viewer.)_lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_Temechon_t_s tutorials... are in html.  I wonder why.  Maybe... cuz HTML has the power he needs to get the job done?  Markdown left him wanting_co_ maybe?  In the face of DK_co_ Davrous_co_ and Temechon ALL writing docs in html sometimes (Temechon at his home site_co_ Dav and DK at MSDN blogs)... I should happily accept markdown as the only authoring medium/format for BD?  Do we have some mixed feelings running around?  Everyone yell _qt_yay markdown_qt_ and then go write docs in html?  ahem._lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_JcPalmer... keep us posted in your search for floating text beside pictures_co_ for markdown.  I have no answers_co_ but you can do like the pros_co_ and write your docs in html.  You_t_ll get the formatting power you need_co_ with html.  _lt_img src_eq__qt_http_dd_//www.html5gamedevs.com/uploads/emoticons/default_ohmy.png_qt_ alt_eq__qt__dd_o_qt_ srcset_eq__qt_http_dd_//www.html5gamedevs.com/uploads/emoticons/ohmy@2x.png 2x_qt_ width_eq__qt_20_qt_ height_eq__qt_20_qt__gt_  Plus_co_ when you maintain complete control_co_ nobody can add bad English_co_ and nobody can come in and remove all your ellipses.  _lt_img src_eq__qt_http_dd_//www.html5gamedevs.com/uploads/emoticons/default_smile.png_qt_ alt_eq__qt__dd_)_qt_ srcset_eq__qt_http_dd_//www.html5gamedevs.com/uploads/emoticons/smile@2x.png 2x_qt_ width_eq__qt_20_qt_ height_eq__qt_20_qt__gt_  (reference to a series of doc-formatting forum posts - where the ellipse police busted me for using too many ellipses)  heh.  I fought the law_co_ and the law left... and never came back.  Poor guy.  He was absolutely right_co_ I use lots of (maybe too many) ellipses.  _lt_img src_eq__qt_http_dd_//www.html5gamedevs.com/uploads/emoticons/default_smile.png_qt_ alt_eq__qt__dd_)_qt_ srcset_eq__qt_http_dd_//www.html5gamedevs.com/uploads/emoticons/smile@2x.png 2x_qt_ width_eq__qt_20_qt_ height_eq__qt_20_qt__gt__lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_Actually_co_ I have no point.  I just wanted to point-out some _qt_stuff_qt_.  Markdown_t_s limp power has only gotten in my way about 100 times... no big deal._lt_/p_gt_\n\n\n\t\t\t\n\t\t_lt_/div_gt_\n\n\t\t_lt_div class_eq__qt_ipsI_qt__gt__lt_/div_gt__lt_/div_gt_"},{"Owner":"Deltakosh","Date":"2015-08-04T17:20:25Z","Content":"_lt_div class_eq__qt_mages_qt__gt_\n\t\t\t\n_lt_p_gt_I agree with the fact that MD are FAR better for documentation than plain html so I_t_m agreeing with Jahow_lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_MD is just about the content. The hosting web site is responsible for the display. I like that. I_t_m writing HTML on my blog because I have no choice. same for Davrous_lt_/p_gt_\n\n\n\t\t\t\n\t\t_lt_/div_gt_\n\n\t\t_lt_div class_eq__qt_ipsI_qt__gt__lt_/div_gt__lt_/div_gt_"},{"Owner":"Wingnut","Date":"2015-08-05T01:51:10Z","Content":"_lt_div class_eq__qt_mages_qt__gt_\n\t\t\t\n_lt_p_gt_Some say xml is about the content.  Why not BDML... babylon docs markup language?  And the site... you bet... it provides the stylesheets.  It provides the presentation_co_ the xml provides the content.  We validate all our BDML (xml) against a DTD.  It_t_s the way normal people do it.  Markdown isn_t_t even a proper way to represent data.  No fields.  Free flying_co_ un-enclosed text... allowed.  No delimiters.  That_t_s just scary_co_ no?_lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_Anyway_co_ the point I was trying to make about msdn... is... why write docs there at all?  Why would you set it up so that someone will have to convert those posts... to markdown someday?  Why weren_t_t they made in markdown initially?  And_co_ why is nobody planning to convert them to markdown?  Why are tutorials still being written with msdn html? _lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_Do people LIKE the pages at BD that say _qt_We_t_re headed for David Catuhe_t_s blog_qt_ and _qt_We_t_re headed for Temechon_t_s website_qt_?  Is there any plans to QUIT writing tutorials on the blogs?_lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_I don_t_t think you guys are giving XML a fair shake... a fair chance at bat.  We see the wonderful affects of casting all scene items as base class NODE_co_ yet when I suggest we cast every section of all tutorials...  as an XML node_co_ it doesn_t_t have the same impact upon anyone. _lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_Granular node-wrangling.  A power CMS between BD and its webserver... a CMS that can assemble a document in a gazillion different ways from a gazillion different pieces.  Each piece_co_ wrapped in a BDML node... with node attributes allowed.  Dynamic html doc assembly_co_ ya know?  No styling_co_ just good clean xml data_co_ no format implied at all.  Or_co_ full styling_co_ just by attaching a single xml stylesheet.  Yum!_lt_/p_gt__lt_p_gt_ _lt_/p_gt__lt_p_gt_Ya_t_ll are going there_co_ anyway_co_ it_t_s just a matter of time. Resistance is futile.  _lt_img src_eq__qt_http_dd_//www.html5gamedevs.com/uploads/emoticons/default_smile.png_qt_ alt_eq__qt__dd_)_qt_ srcset_eq__qt_http_dd_//www.html5gamedevs.com/uploads/emoticons/smile@2x.png 2x_qt_ width_eq__qt_20_qt_ height_eq__qt_20_qt__gt_  Markdown will give you cancer._lt_/p_gt_\n\n\n\t\t\t\n\t\t_lt_/div_gt_\n\n\t\t_lt_div class_eq__qt_ipsI_qt__gt__lt_/div_gt__lt_/div_gt_"},{"Owner":"JohnK","Date":"2015-08-05T08:31:15Z","Content":"_lt_div class_eq__qt_mages_qt__gt_\n\t\t\t\n_lt_p_gt_Here_t_s my tuppence worth_co_ how about pushing wingnut_t_s idea even further put it all together and have a front end for the user that is a page template where the documenter just adds the content_co_ button here to add a link to another page_co_ button there playgound link_co_ button there add image_co_ you could even have preset image sizes and make the images fit. Each page would have a consistent style_co_ bullet points would be of a fixed type and ahhhhhhhh  wingnuts_lt_span_gt_ _lt_img src_eq__qt_http_dd_//www.html5gamedevs.com/uploads/emoticons/default_ph34r.png_qt_ alt_eq__qt__dd_ph34r_dd__qt_ srcset_eq__qt_http_dd_//www.html5gamedevs.com/uploads/emoticons/ph34r@2x.png 2x_qt_ width_eq__qt_20_qt_ height_eq__qt_20_qt__gt__lt_/span_gt_ go to me_co_ I tried to resist but it was futile _lt_span_gt_ _lt_img src_eq__qt_http_dd_//www.html5gamedevs.com/uploads/emoticons/default_ohmy.png_qt_ alt_eq__qt__dd_o_qt_ srcset_eq__qt_http_dd_//www.html5gamedevs.com/uploads/emoticons/ohmy@2x.png 2x_qt_ width_eq__qt_20_qt_ height_eq__qt_20_qt__gt__lt_/span_gt__lt_span_gt_ _lt_img src_eq__qt_http_dd_//www.html5gamedevs.com/uploads/emoticons/default_smile.png_qt_ alt_eq__qt__dd_)_qt_ srcset_eq__qt_http_dd_//www.html5gamedevs.com/uploads/emoticons/smile@2x.png 2x_qt_ width_eq__qt_20_qt_ height_eq__qt_20_qt__gt__lt_/span_gt__lt_span_gt_ _lt_img src_eq__qt_http_dd_//www.html5gamedevs.com/uploads/emoticons/default_biggrin.png_qt_ alt_eq__qt__dd_D_qt_ srcset_eq__qt_http_dd_//www.html5gamedevs.com/uploads/emoticons/biggrin@2x.png 2x_qt_ width_eq__qt_20_qt_ height_eq__qt_20_qt__gt__lt_/span_gt__lt_/p_gt_\n\n\n\t\t\t\n\t\t_lt_/div_gt_\n\n\t\t_lt_div class_eq__qt_ipsI_qt__gt__lt_/div_gt__lt_/div_gt_"}]