Add examples to XML params

[mattfrear]

Fixes #1628.
I ensure the example type is the correct type and not always a string.
Includes unit tests and updated Readme.

[mattfrear]

I use the NCrunch test runner so I added this. I can remove it if you prefer.

[domaindrivendev]

👍 @mattfrear

[Ben230]

Hi @mattfrear, when do you think it would be possible to accept other datatypes e.g. guids rather than just primitive data types? Love the work you are doing btw!

[foriequal0]

Hi. Would you mind if I ask why did you put examples under the parameter's schema? I think it would've generated a more concise document if you put it parameter.Example in XmlCommentsParameterFilter.

[mattfrear]

Hi. Would you mind if I ask why did you put examples under the parameter's schema? I think it would've generated a more concise document if you put it parameter.Example in XmlCommentsParameterFilter.

That's a good question. I didn't know that XmlCommentsParameterFilter exists. I added it to the schema.Example because I was copying the existing logic which sets schema examples from XML comments.
I think you are correct - the XmlCommentsParameterFilter is the more correct place to set this.

[foriequal0]

@mattfrear Thank you for the clarification 👍

[gohawks3]

Hi Matt, love your work! would you please add an example for IList param type? Is it supported?

[mattfrear]

Hi Matt, love your work! would you please add an example for IList param type? Is it supported?

Yes @gohawks3, lists are supported, see this comment:

#1676 (comment)