NSwag.AzureFunctionsV2 icon indicating copy to clipboard operation
NSwag.AzureFunctionsV2 copied to clipboard

Solve XML documentation in Azure

Open LockTar opened this issue 5 years ago • 2 comments

Hi,

I know there is a known issue about the XML documentation in Azure.

I want to help. Do you know where the xml document is added. I think this is done in the RunOperationProcessorsAsync method. To be more specific, I think it is getting the xml document/path from the context right? So line:

var context = new OperationProcessorContext(document, operationDescription, staticAzureFunctionClassType,
                methodInfo, swaggerGenerator, Settings.SchemaGenerator, schemaResolver, Settings, allOperations);

Which setting is used for the XML file path? I can't find it.

LockTar avatar Oct 31 '19 13:10 LockTar

I think the XML document is found via NSwag to another package called Namotion.Reflection. Opened a new issue there as well.

LockTar avatar Oct 31 '19 14:10 LockTar

Hi, I am testing "NSwag.SwaggerGeneration.AzureFunctionsV2" at the moment and I am missing my xml comments at all in my generated swagger documentation.

I think the problem above is related to my issue, right? I could not get it to work locally or remotely so far.

mlinschulte avatar Jun 18 '20 16:06 mlinschulte