<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<style type="text/css" style="display:none;"> P {margin-top:0;margin-bottom:0;} </style>
</head>
<body dir="ltr">
<div class="elementToProof" style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
Dear all,</div>
<div class="elementToProof" style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
I have uploaded a new version of the Github TN to CWE. This can be found at the following URL;</div>
<div class="elementToProof" style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
<br>
</div>
<ul style="margin-block: 0px; list-style-type: disc;">
<li style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
<div class="elementToProof"><span style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"><a href="https://cwe.ccsds.org/css/docs/CSS-SM/CWE%20Private/Tech%20Note%20Development/CSSA%20902-TN-00%20Tooling%2C%20Guidelines%20and%20Naming%20Conventions%20for%20902%20Usage%20of%20GitHub%20-%20Technical%20Note/CSSA%20902-TN-00%20Tooling%2C%20Guidelines%20and%20Naming%20Conventions%20for%20902%20Usage%20of%20GitHub%20-%20Technical%20Note-CRH-20231130.doc?d=wfd6b548fd0c240d3a67e7c82760ba745" id="LPlnk221783" class="OWAAutoLink">https://cwe.ccsds.org/css/docs/CSS-SM/CWE%20Private/Tech%20Note%20Development/CSSA%20902-TN-00%20Tooling%2C%20Guidelines%20and%20Naming%20Conventions%20for%20902%20Usage%20of%20GitHub%20-%20Technical%20Note/CSSA%20902-TN-00%20Tooling%2C%20Guidelines%20and%20Naming%20Conventions%20for%20902%20Usage%20of%20GitHub%20-%20Technical%20Note-CRH-20231130.doc?d=wfd6b548fd0c240d3a67e7c82760ba745</a></span></div>
</li></ul>
<div class="elementToProof" style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
<br>
</div>
<div class="elementToProof" style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
and addresses in full or in part the following actions;</div>
<div class="elementToProof" style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
<br>
</div>
<ol start="1" data-editing-info="{"orderedStyleType":1,"unorderedStyleType":1}" data-listchain="__List_Chain_1220" style="margin-block: 0px; list-style-type: decimal;">
<li style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
<div class="elementToProof"><span style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"><i>231110-01 "Update GitHub technote to include naming convention for hackathon repos and teams and sections as appropriate for new tooling
(e.g., eclipse markdown editor)"</i> - Naming conventions for Hackathon Repos and Teams have been added, section on markdown editor has been added (see action 231110-03 below) and section on OpenAPI editor has been added (see action 231110-4 below).</span></div>
</li></ol>
<div class="elementToProof"><span style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"><br>
</span></div>
<ol start="2" data-editing-info="{"orderedStyleType":1,"unorderedStyleType":1}" data-listchain="__List_Chain_1220" style="margin-block: 0px; list-style-type: decimal;">
<li style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
<div class="elementToProof"><span style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"><i>231110-03 "Investigate eclipse mark down editors and report"</i> - there are several add in for Eclipse that support to a greater of
lesser extend the markdown syntax. Some however have not been updated for several years, one (supposidly tailored for GitHub markdown) no longer seems to be available, others are implemented by 1 man and his dog, one which supports pretty much all of both
the Basic and Extended markdown syntax uses an external server to render the markdown onto a web browser but is very slow. All need to be installed via the Eclipse marketplace (which may have its own issues for some users, see action 231110-04 below). To cut
a long story short my assessment is that the best choice for our purposes is the Mylyn WikiText editor which actually comes preinstalled in the Eclipse Modelling Framework, so nothing extra has to be installed. This fully supports the basic markdown syntax,
but not the full extended syntax. See Annex F in the TN for more details.</span></div>
</li></ol>
<div class="elementToProof"><span style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"><br>
</span></div>
<ol start="3" data-editing-info="{"orderedStyleType":1,"unorderedStyleType":1}" data-listchain="__List_Chain_1220" style="margin-block: 0px; list-style-type: decimal;">
<li style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
<div class="elementToProof"><span style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"><i>231110-04 "Investigate eclipse OpenAPI editor</i>" - there are 2 OpenAPI editors available in Eclipse. One, OpenAPI editor has a commercial
license, which to all practical intents and purposes rules it out. The second, OpenAPI (Swagger) Editor, appears (after a minimal examination (I need to play with it quite a lot more...) to have quite a large set of functionality - how useful this really
is I can't say at the moment. There are a couple of points worth noting;</span></div>
</li></ol>
<div class="elementToProof"><span style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"><br>
</span></div>
<ol start="4" data-editing-info="{"orderedStyleType":1,"unorderedStyleType":1}" data-listchain="__List_Chain_1220" style="margin-block: 0px; list-style-type: decimal;">
<ol start="1" style="margin-block: 0px; list-style-type: lower-alpha;">
<li style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
<div class="elementToProof"><span style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">The OpenAPI (SWAGGER) Editor offers integration with the 42Cruch Platform. This needs to be investigated further to clarify what the possible
benefits and implications would be, see;</span></div>
</li></ol>
</ol>
<div class="elementToProof"><span style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"><br>
</span></div>
<ul data-editing-info="{"orderedStyleType":1,"unorderedStyleType":1}" style="margin-block: 0px; list-style-type: disc;">
<ul style="margin-block: 0px; list-style-type: circle;">
<ul style="margin-block: 0px; list-style-type: square;">
<li style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
<span style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"><a href="https://42crunch.com/" id="LPlnk348541" class="OWAAutoLink">https://42crunch.com/</a></span></li></ul>
</ul>
</ul>
<div><span style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"><br>
</span></div>
<ul data-editing-info="{"orderedStyleType":1,"unorderedStyleType":1}" style="margin-block: 0px; list-style-type: disc;">
<ol start="2" data-listchain="__List_Chain_1221" style="margin-block: 0px; list-style-type: lower-alpha;">
<li style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
<span style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">The Editor has to be installed from the Eclipse Marketplace. During the installation procedure (documented in Annex G of the TN), along with the License acceptance
form that is pretty standard when installing add-ins to Eclipse either via the marketplace or otherwise a "Trust Authorities" screen is displayed (see below). This is not unique to the OpenAPI (swagger) editor, similar screens were also displayed with all
the markdown plug-ins installed via the marketplace.</span></li></ol>
</ul>
<div class="elementToProof" style="margin-left: 80px;"><span style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"><img id="imageSelected0" width="757" height="633" style="width: 757px; height: 633px;" size="90148" contenttype="image/png" data-outlook-trace="F:1|T:1" src="cid:4f371ca7-f16a-44c8-b014-8511fceca75c"></span></div>
<div class="elementToProof" style="margin-left: 80px;"><span style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">This may need to be checked against the security policies of some of our organizations...</span></div>
<div class="elementToProof" style="margin-left: 80px;"><span style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"><br>
</span></div>
<ol start="4" data-listchain="__List_Chain_1220" style="margin-block: 0px; list-style-type: decimal;">
<ol start="1" style="margin-block: 0px; list-style-type: lower-alpha;">
<li style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
<div class="elementToProof" style="margin-left: 0px; font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
<span style="letter-spacing: normal; font-weight: 400;">Further along in the installation a "Trust Artifacts" screen is displayed (again this is not unique to the OpenAPI (swagger) editor, similar screen were displayed with all the markdown plug-ins installed
via the marketplace). Once again I fear that some organizations security policies may need to be checked to see if this is acceptable.</span></div>
</li></ol>
</ol>
<div style="margin-left: 80px;"><span style="letter-spacing: normal; font-family: Arial, Helvetica, sans-serif; font-size: 12pt; font-weight: 400; color: rgb(0, 0, 0);"><img id="imageSelected1" width="759" height="319" style="width: 759px; height: 319px;" size="29190" contenttype="image/png" data-outlook-trace="F:1|T:1" src="cid:6afd7831-4312-40ac-abd1-1e4ace6e1b19"></span></div>
<div class="elementToProof" style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
<br>
</div>
<div class="elementToProof" style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
<br>
</div>
<div class="elementToProof"><span style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">Whilst I think the first 2 actions can be closed, the third (</span><span style="letter-spacing: normal; font-family: Arial, Helvetica, sans-serif; font-size: 16px; font-weight: 400; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">231110-04</span><span style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">)
definitely needs further investigation.</span></div>
<div class="elementToProof"><span style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"><br>
</span></div>
<div class="elementToProof"><span style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">For those of you that already have Papyrus and the XML Editors installed in your Eclipse Modelling Framework installation I would recommend
that (even if you're ok with the Trust acceptance aspects) you don't yet install the OpenAPI (swagger) Editor. Reason for this is that the Papyrus installation incompatibilities that caused us some fun in Den Haag have not yet been fully resolved, so installing
the OpenAPI (swagger) Editor (or pretty much anything else) will break Papyrus.</span></div>
<div class="elementToProof"><span style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"><br>
</span></div>
<div class="elementToProof"><span style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">Eclipse has 4 releases a year, Papyrus doesn't make a new release for each Eclipse release, maybe for 2 or 3 of the Eclipse releases in
a year. The next Eclipse release will be 2023-12 which I think should be available in early January, this will also include a new Papyrus release. The (probable) good news is that this should solve the problem. I tried installing one of the Papyrus nightly
builds into the 2023-09 version of EMF and didn't run into the compatibility issues, so fingers crossed. Note that all the testing of markdown editors, openapi editors and different versions of EMF and Papyrus have been done in virtual machines (running windows
11) so I don't b*ll*x up my production environment</span></div>
<div class="elementToProof"><span style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"><br>
</span></div>
<div class="elementToProof"><span style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">Cheers for now,</span></div>
<div class="elementToProof"><span style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"><br>
</span></div>
<div class="elementToProof"><span style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">Colin</span></div>
<div class="elementToProof"><span style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"><br>
</span></div>
<div class="elementToProof"><span style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"><br>
</span></div>
<div id="Signature">
<p style="margin: 0cm; font-family: Calibri, sans-serif; font-size: 11pt;"><span style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: black; background-color: white;"><i>Dr. Colin R. Haddow</i></span><span style="font-family: Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
</span><span style="color: rgb(0, 0, 0);"> </span></p>
<p style="margin: 0cm 0cm 8pt; font-family: Calibri, sans-serif; font-size: 11pt;">
<span style="font-family: "ST Huntington"; font-size: 18pt; color: aqua; background-color: white;"><b><i>Scotty Consulting UG
</i></b></span><span style="font-family: Arial, sans-serif; color: black; background-color: white;"> </span></p>
</div>
</body>
</html>