c9a0137d81
Updates to support NSwag v12 ( #10148 )
...
* casing fixes
* image refresh
* Initial changes to NSwag document.
* Added new screenshots
* Last changes to NSwag document.
* Update aspnetcore/tutorials/getting-started-with-NSwag.md
Co-Authored-By: daveabrock <daveabrock@gmail.com>
* Update aspnetcore/tutorials/getting-started-with-NSwag.md
Co-Authored-By: daveabrock <daveabrock@gmail.com>
* Update aspnetcore/tutorials/getting-started-with-NSwag.md
Co-Authored-By: daveabrock <daveabrock@gmail.com>
* Update aspnetcore/tutorials/getting-started-with-NSwag.md
Co-Authored-By: daveabrock <daveabrock@gmail.com>
* Update aspnetcore/tutorials/getting-started-with-NSwag.md
Co-Authored-By: daveabrock <daveabrock@gmail.com>
* Update aspnetcore/tutorials/getting-started-with-NSwag.md
Co-Authored-By: daveabrock <daveabrock@gmail.com>
* Update aspnetcore/tutorials/getting-started-with-NSwag.md
Co-Authored-By: daveabrock <daveabrock@gmail.com>
* Update aspnetcore/tutorials/getting-started-with-NSwag.md
Co-Authored-By: daveabrock <daveabrock@gmail.com>
* Update aspnetcore/tutorials/getting-started-with-NSwag.md
Co-Authored-By: daveabrock <daveabrock@gmail.com>
* Update aspnetcore/tutorials/getting-started-with-NSwag.md
Co-Authored-By: daveabrock <daveabrock@gmail.com>
* Update aspnetcore/tutorials/getting-started-with-NSwag.md
Co-Authored-By: daveabrock <daveabrock@gmail.com>
* Update aspnetcore/tutorials/getting-started-with-NSwag.md
Co-Authored-By: daveabrock <daveabrock@gmail.com>
* Update aspnetcore/tutorials/getting-started-with-NSwag.md
Co-Authored-By: daveabrock <daveabrock@gmail.com>
* Update aspnetcore/tutorials/getting-started-with-NSwag.md
Co-Authored-By: daveabrock <daveabrock@gmail.com>
* Update aspnetcore/tutorials/getting-started-with-NSwag.md
Co-Authored-By: daveabrock <daveabrock@gmail.com>
* Update aspnetcore/tutorials/getting-started-with-NSwag.md
Co-Authored-By: daveabrock <daveabrock@gmail.com>
* Update aspnetcore/tutorials/getting-started-with-NSwag.md
Co-Authored-By: daveabrock <daveabrock@gmail.com>
* Update aspnetcore/tutorials/getting-started-with-NSwag.md
Co-Authored-By: daveabrock <daveabrock@gmail.com>
* Update aspnetcore/tutorials/getting-started-with-NSwag.md
Co-Authored-By: daveabrock <daveabrock@gmail.com>
* Update aspnetcore/tutorials/getting-started-with-NSwag.md
Co-Authored-By: daveabrock <daveabrock@gmail.com>
* Update aspnetcore/tutorials/getting-started-with-NSwag.md
Co-Authored-By: daveabrock <daveabrock@gmail.com>
* Update aspnetcore/tutorials/getting-started-with-NSwag.md
Co-Authored-By: daveabrock <daveabrock@gmail.com>
* Update aspnetcore/tutorials/getting-started-with-NSwag.md
Co-Authored-By: daveabrock <daveabrock@gmail.com>
2019-01-03 14:31:47 -06:00
0ee6b101d9
delete map and min files ( #9310 )
2018-10-31 14:26:48 -10:00
5704de168e
Implicit versioning of the All package ( #9223 )
...
Fixes #9219
@JunTaoLuo Dan calls out the implicit versioning "for 2.1 SDK or later;" however, we don't usually version the doc content by SDK release. We might need to say something for this update in the passage that I'm adding to the All topic (*aspnetcore/fundamentals/metapackage.md*) about which SDK version this applies to. I don't know if that's something that you would like to do or what version to call out.
I also remove the version from the samples. We also assume that devs are using the latest SDK with our samples.
2018-10-25 15:16:50 -10:00
8e6dd4a7f4
Drop version from App package ( #8881 )
...
Addresses #8579
I might be getting the hang of **_find and replace_** now. 😝
This doesn't touch a couple that ref 2.2.0. I'll tidy those up on https://github.com/aspnet/Docs/issues/8518 after 2.2 RTM.
2018-10-06 17:10:28 -10:00
d6ab352542
Use API Explorer based NSwag generator and middlewares ( #8572 )
...
- Upgrade NSwag (samples) and use new API Explorer based generators (the reflection based generators are deprecated soon)
- Some text improvements
- Change "Open API" to "OpenAPI" (correct name)
- Use new Swagger UI 3 in samples
[Internal Review Page](https://review.docs.microsoft.com/en-us/aspnet/core/tutorials/getting-started-with-nswag?view=aspnetcore-2.1&branch=pr-en-us-8572&tabs=visual-studio%2Cvisual-studio-xml )
2018-09-20 11:32:52 -05:00
46f41d4774
Update All and App package versions ( #8513 )
2018-09-13 11:39:23 -05:00
1a0f79a8fe
Update All/App package version ( #8489 )
2018-09-11 08:53:03 -05:00
34b33e245b
Add version to App package references ( #7551 )
...
Fixes #7532
2018-07-10 22:43:09 -05:00
788f3eb9a5
[WIP] Updates to web API help pages tutorial for XML doc gen ( #7385 )
...
Updates to web API help pages tutorial for XML doc gen
2018-06-29 15:20:48 -05:00
4bad6f3978
Update web API sample apps to 2.1 RTM implicit packageref ( #7245 )
...
Addresses https://github.com/aspnet/Docs/issues/7239
2018-06-22 12:52:25 -05:00
06d5f6cfb5
Fix Swashbuckle tutorial for 1.x apps ( #6761 )
...
Addresses https://github.com/aspnet/Docs/issues/6686 (still need to address deployment concerns)
Addresses https://github.com/aspnet/Docs/issues/5495
**Changes**
- Update 2.1 sample app from RC1 to RTM
- Simplify sample app download link markup
[Internal Review Page](https://review.docs.microsoft.com/en-us/aspnet/core/tutorials/getting-started-with-swashbuckle?view=aspnetcore-1.1&branch=pr-en-us-6761#add-and-configure-swagger-middleware )
2018-05-31 20:32:30 -05:00
a32fbb4351
EF Migrations vs. Swashbuckle ( #6380 )
...
* Update Startup.cs
This sample causes a FileNotFoundException with Entity Framework Core Migrations - i.e. when executing "dotnet ef migrations add new", the GetEntryAssembly call returns "ef", and "ef.xml" does not exist in the build folder.
* Update Startup.cs
This sample causes a FileNotFoundException with Entity Framework Core Migrations - i.e. when executing "dotnet ef migrations add new", the GetEntryAssembly call returns "ef", and "ef.xml" does not exist in the build folder.
2018-05-12 08:19:20 -05:00
99b4ad3d1c
Update Swagger tutorials for 2.1 ( #6193 )
...
* Update Swagger tutorials for 2.1
* Improve PMC instructions
* Verbiage tweaks
* Fix code highlighting in NSwag tutorial
* Remove unnecessary screenshots
* Apply 2.1 moniker to Swashbuckle tutorial
* Replace line numbers with region name
* NSwag 2.1 sample app updates
* Update Data annotations section of NSwag doc
* Add tip to NSwag doc
* Minor tweaks
* NSwag doc updates
* Fix API ref links
* Add section for adding API info
* Add sentence to Customize section
* Convert H2 heading to H3
* React to feedback
2018-05-09 14:54:24 -05:00
f8571ffada
Update Web API tutorial's Swashbuckle dependency to 2.x ( #5803 )
...
* Update tutorial to Swashbuckle 2.x
* Update the Customize the UI instructions
* React to Acrolinx feedback
2018-03-26 15:50:15 -05:00
01552df34c
Upgrade to latest Microsoft.AspNetCore.All and NSwag.AspNetCore ( #5774 )
2018-03-22 09:24:02 -05:00
b57b0cb67d
[WIP] Changed Web Api Help Pages using Swagger, added sub pages for NSwag & Swashbuckle ( #5622 )
...
Changed Web Api Help Pages using Swagger, added sub pages for NSwag & Swashbuckle
2018-03-09 17:12:20 -06:00
f48a87e02c
Add note about warning suppression ( #5347 )
2018-02-02 12:33:23 -10:00
ae5d14d6a0
add notice regarding undocumented methods notices and updated code ( #5089 )
...
* add notice regarding undocumented methods notices and updated code for pointing to the xml file
* Update web-api-help-pages-using-swagger.md
* cleanup using in startup.cs and updated notice message regarding missing xml comment
* add missing startup.cs changes
* Minor edit
2018-01-08 10:15:17 -06:00
7c63421a6d
Call `UseMvc()` instead of `UseMvcWithDefaultRoute()` ( #4204 )
2017-09-05 08:54:25 -05:00
85431318e8
2.0 updates to Swagger tutorial ( #4145 )
...
* 2.0 updates to Swagger tutorial
* More edits
* Add missing wwwroot folder
* More edits
* More edits
* Update code comment
* Move UseMvc call to last invocation
* Update property name in JSON sample
* Convert UseMvcWithDefaultRoute() to UseMvc()
* Add Startup2.cs
* Simplify the .csproj file
* Adopt new WebHost pattern in Program.cs
* walk through --> walkthrough
* Remove unused controller
* Update images
* Remove unused controller
* More edits
* Wordsmithing
* Provide more detail in UI customization text
* Modify JSON sample
* Add keywords
* Implement Rick's suggestions
* Add cross platform instructions
* Update image
* Convert 2 sentences into list
2017-09-01 15:24:18 -05:00
5a1a06b2c4
update to csproj ( #2751 )
2017-02-12 15:04:45 -10:00
49f9c9b8b0
force add referenced wwwroot files for swagger sample app
2017-01-22 13:03:34 -08:00
6e1b240033
update swagger tutorial to reflect latest Swashbuckle changes
2017-01-20 00:58:00 -08:00
21dacc2e8e
Solve cross platform issue
...
fix issue - "Unhandled Exception: System.IO.FileNotFoundException" run
on Mac
2016-11-11 16:10:48 +08:00
e9c1419175
Add docfx content
2016-10-28 10:35:15 -07:00
Dave Brock
Rick Anderson
Luke Latham
Rico Suter
Scott Addie
BusyCoding
Scott Addie
Alexandru Bucur
Bader Nasser Al-Hashmi
damienbod
domaindrivendev
Charlie Chu
Daniel Roth