Product: PowerShell Universal
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.
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.