Consolidate code repo and wiki about dis-tutorial HOT 3 OPEN

@brutzman @terry-norbraten are either of you familiar with the plan for the dis-tutorial repository? It appears like @mcgredonps was the primary author (based on number of commits) but there were a number of contributions from others.

I see that there is a tutorial written within the git repo markdown pages and another in the git repo wiki pages. Was it intended to be the same tutorial? Is one version newer than the other? From the dates of changes it's not obvious to me, the two copies appear to be authored roughly in parallel between 2017 and 2019. But there are significant differences between the two copies.

The git repo markdown pages were authored between Jan 2, 2017 and Jan 9, 2019 .

Whereas the wiki pages were authored between Oct 28, 2017 and March 12, 2019

My thought is it would be nice if could consolidate the two tutorials (if indeed they were intended to be one tutorial), but I don't have enough background to understand if we should straight up delete one copy and keep the other or how to proceed.

from dis-tutorial.

from dis-tutorial.

There is a lot of good information in the tutorial, but it never reached fruition as a useful (recommendable) document.

We have no funding or expert availability to pursue the tutorial this year, though we do aspire to work on DIS 8.

If we might structure the tutorial information in an XML document that corresponded to PDUs and abstract classes, plus other things, then we would be able to integrate it into our code autogeneration as Javadoc, python comments, C++/C# documentation, etc. I've done this kind of thing before to good effect.

Divide-and-conquer suggestion: why don't we integrate pertinent parts directly into the XML that captures DIS7, meaning that much of it could eventually port to DIS8 autogeneration when we get there. Specifically, changing the @comment attribute (found in current XML) into @description (terse form) and @explanation (tutorial detail) might provide space to put a lot of the material into context, providing a good start on such refactoring.

• https://github.com/open-dis/opendis7-source-generator/tree/master/xml/dis_7_2012

This is a good project for someone that could encourage a number of contributions. Design is key. I'd expect that the SISO working group would let us apply blocks of prose freely since we would not be violating IEEE copyright.

from dis-tutorial.