Swagger documentation when -Path is used

Product: PowerShell Universal
Version: 3.94

When moving endpoint definition to a file and using -Path instead of -Endpoint, it appears that any comment-based help isn’t included in the Swagger documentation. Is this expected behavior?

The first screenshot below is what the swagger documentation page looks like for an endpoint using -Path.

This screenshot shows an endpoint defined in endpoints.ps1 using -Endpoint, and is what I would have expected even using -Path.

This isn’t expected behavior. I opened and issue to track this here: Endpoint Docs with -Path · Issue #2464 · ironmansoftware/issues · GitHub

I’ll circle back if I can’t reproduce it.

1 Like

Left a commen in Github, but wanted to follow up here as well. I believe the issue came down to path definition, using $Repository at config time instead just at run time.