WIP: Generate Mermaid HTML diagrammer from input assembly via ilspycmd

[h0lg]

In this PR I contribute https://github.com/h0lg/netAmermaid to ILSpy - building it into ILSpyX and making it accessible via ilspycmd as discussed in h0lg/netAmermaid#6 .

At the time of writing both the

• dev loop for the C# bits in Visual Studio and
• a separate one for the HTML/JS/CSS development in VsCode

are functional.

Still TO DO:

• contribute the existing doco
• write new dev doco to edit HTML/JS/CSS in VsCode and which tasks to run in which order there
• renaming / rebranding: generated diagrammers still point to the old repo, use the original icon, are branded as netAmermaid

[christophwille]

Regarding documentation - I would propose:

• add a separate section in https://github.com/icsharpcode/ILSpy/tree/master/ICSharpCode.ILSpyCmd (README.md) "Diagramming" with common command line samples and basic usage. Reference the wiki for
• Deep-dive "how-to-use" in the Wiki
• Deep-dive "developers working on the feature" info can go in a README inside the MermaidDiagrammer folder (exclude from build, no images)

[christophwille]

Some general notes

• Please add file headers to the C# files, see eg https://github.com/icsharpcode/ILSpy/blob/master/ILSpy/Util/MessageBus.cs
• As for how our repo works - the single most important file is https://github.com/icsharpcode/ILSpy/blob/master/BuildTools/pre-commit - this format checks like the build server would.

[h0lg]

• As for how our repo works - the single most important file is https://github.com/icsharpcode/ILSpy/blob/master/BuildTools/pre-commit - this format checks like the build server would.

0_o wow. I never worked in a repo where you get punished that hard for simple committing. Is there another way I can apply these formattings, e.g. pre-push? This is poison to my flow.

[christophwille]

I am using https://marketplace.visualstudio.com/items?itemName=mynkow.FormatdocumentonSave

[h0lg]

I am using https://marketplace.visualstudio.com/items?itemName=mynkow.FormatdocumentonSave

If that's all the script does - I have an extension like that running as well. I also found https://github.com/icsharpcode/ILSpy/blob/master/BuildTools/format.bat which seems to work if I replace the bash path to match my environment.

[christophwille]

That was my earlier reference of "end user documentation in the Wiki" - basically this document => Wiki.

[h0lg]

Got you. I understand you mean a new top-level page in https://github.com/icsharpcode/ILSpy/wiki

[christophwille]

Yes - maybe simply call it Diagramming

[h0lg]

I've cleaned and split the doco up further

• moving the ilspycmd examples into the ilspycmd Readme (after the help output) and
• extracting the How does it work? chapter into a developer-facing readme
• renaming the leftovers to Wiki.md (because that's where they'll go)

Should html/UsingDiagrammer.md remain a standalone page at this point (and if so, where should it go) or be merged into Wiki.md?