MarkdownGenerator icon indicating copy to clipboard operation
MarkdownGenerator copied to clipboard

Support <para>, <example>, <code> tags

Open fraguada opened this issue 8 years ago • 6 comments

I've been pleasantly surprised about the utility of this repo. I've used it to make the reference to my class library here. It would be great to extend this to support <para>, <example>, and <code> tags. Perhaps all tags for that matter.

For example, I wanted to have the summary on different lines, and added a code example to this object: https://github.com/mcneel/ThreeLib/blob/master/src/THREE/Scenes/Scene.cs#L7-L21. These are not picked up by the VSDocParser.

I will attempt to extend the functionality when I get a change. Thanks for a nice tool!

fraguada avatar Nov 14 '17 20:11 fraguada

Thank you for use! Okay, I'll think about how to format.

neuecc avatar Nov 15 '17 13:11 neuecc

I would suggest to generate an own file for each member where those tags can be displayed. Something like microsoft is dooing it: List<T>.Find(Predicate<T>) Method

patrickweegen avatar Dec 22 '17 15:12 patrickweegen

<para> tag will be very helpfull, long comment text is hard to read currently. @neuecc If you accept me to help with it, I can do it (or maybe make pull-request anyway when find time to discover it deeply).

KonH avatar Feb 23 '18 05:02 KonH

I've work on support for "example"-tags, it not ready to be a PR but if @neuecc would like to I'll all open to create one.

https://github.com/enkelmedia/MarkdownGenerator/tree/method-details

enkelmedia avatar May 25 '19 11:05 enkelmedia

@neuecc To update on this one.

I've made quite some changes to the way to render methods and adding support for example and code, also adding support for code inside summery. These changes live in my "dev"-branch

https://github.com/enkelmedia/MarkdownGenerator/tree/dev

I could try to clean up the code and create a pull request but only you would consider a merge?

enkelmedia avatar May 27 '19 11:05 enkelmedia

@enkelmedia yes, if you send PR, I'll merge it.

neuecc avatar May 28 '19 01:05 neuecc