I spent a day or more researching this so that I could use Swagger-UI in my ASP.NET Core API which is used with a reverse-proxy and virtual directory. In the end found Swagger-UI requires relative URLs to start with a period. Related to https://github.com/swagger-api/swagger-ui/issues/4107
Hoping this documentation note will help others.
When creating a new PR, please do the following and delete this template text:
* Reference the issue number if there is one:
Fixes #Issue_Number
> The "Fixes #nnn" syntax in the PR description causes
> GitHub to automatically close the issue when this PR is merged.
* Add docs for api conventions and analyzers
Fixes#8332
* Edit pass on API conventions and analyzers content (#9574)
* Edit pass on 2.2 API docs (#9578)
* Scottaddie/open api patch (#9582)
* Edit pass on 2.2 API docs
* Resolve build warning
* Fix list formatting
This addresses the issue #9557 that I was working on with @scottaddie.
Unfortunately, I experienced severe GitHub workflow issues, and the pull request was closed.
Fixes#9470
[Internal Review Topic (How to download a sample section)](https://review.docs.microsoft.com/en-us/aspnet/core/index?view=aspnetcore-1.0&branch=pr-en-us-9544#how-to-download-a-sample)
I'm not very trusting of ✨ *Magic Build Systems* ✨. I usually encode reserved DocFX characters outside of code-fenced content ... *they'll **never** break this way no matter what the build system thinks about them*.
If you prefer that I go with either a backslash (safe) or roll the 🎲🎲 and use unencoded chars with build system processing trust, let me know which alternate way you would like to go. Again, my approach is **_bulletproof_**.
Thanks @rswetnam! 🚀
Making it a bit clearer that the [controller] name replacement of MyNameController is by naming convention.
<!--
When creating a new PR, please do the following:
* Reference the issue number if there is one, e.g.:
Fixes #Issue_Number
The "Fixes #nnn" syntax in the PR description allows GitHub to automatically close the issue when this PR is merged.
NOTE: This is a comment; please type your descriptions above or below it.
-->
<!--
When creating a new PR, please do the following:
* Reference the issue number if there is one, e.g.:
Fixes #Issue_Number
The "Fixes #nnn" syntax in the PR description allows GitHub to automatically close the issue when this PR is merged.
NOTE: This is a comment; please type your descriptions above or below it.
-->
More for #9441 with a bit of refactoring.
- IISServerOptions (inproc) are unique from IISOptions (out of proc)
- Move HTTP/2 topic lower in the document (flow felt off by having it before how to enable IISIntegration)
- Remove stop/starting app pool in favor of dropping app_offline (@shirhatti for thoughts)
- Generalize addressing AspNetCore behind IIS (remove reverse proxy stuff).
Ahmed Yahia
Robb Schiefer
Rick Anderson
Pranav K
Luke Latham
Scott Addie
Daniel Morrison
Steve Gordon
Andrew Stanton-Nurse
Vincent Pestana
Tom Dykstra
Daniel Abbatt
Hao Kung
John Luo
BrennanConroy
Stephen Halter
Kevinio04
Justin Kotalik
Mikael Mengistu
Sayed Ibrahim Hashimi