Commit Graph

22 Commits (91a2e221a9a12dbe657dc48416cafa01a8b5c40a)

Author SHA1 Message Date
Luke Latham 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
Rico Suter 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
Luke Latham 46f41d4774
Update All and App package versions (#8513) 2018-09-13 11:39:23 -05:00
Luke Latham 1a0f79a8fe
Update All/App package version (#8489) 2018-09-11 08:53:03 -05:00
Luke Latham 34b33e245b Add version to App package references (#7551)
Fixes #7532
2018-07-10 22:43:09 -05:00
Scott Addie 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
Scott Addie 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
Scott Addie 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
BusyCoding 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
Scott Addie 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
Scott Addie 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
Rico Suter 01552df34c Upgrade to latest Microsoft.AspNetCore.All and NSwag.AspNetCore (#5774) 2018-03-22 09:24:02 -05:00
Rico Suter 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
Scott Addie f48a87e02c Add note about warning suppression (#5347) 2018-02-02 12:33:23 -10:00
Alexandru Bucur 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
Bader Nasser Al-Hashmi 7c63421a6d Call `UseMvc()` instead of `UseMvcWithDefaultRoute()` (#4204) 2017-09-05 08:54:25 -05:00
Scott Addie 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
damienbod 5a1a06b2c4 update to csproj (#2751) 2017-02-12 15:04:45 -10:00
domaindrivendev 49f9c9b8b0 force add referenced wwwroot files for swagger sample app 2017-01-22 13:03:34 -08:00
domaindrivendev 6e1b240033 update swagger tutorial to reflect latest Swashbuckle changes 2017-01-20 00:58:00 -08:00
Charlie Chu 21dacc2e8e Solve cross platform issue
fix issue - "Unhandled Exception: System.IO.FileNotFoundException" run
on Mac
2016-11-11 16:10:48 +08:00
Daniel Roth e9c1419175 Add docfx content 2016-10-28 10:35:15 -07:00