Update cmdlet docs from Kestrun/Kestrun@06bda35

Author: github-actions[bot]

docs/pwsh/tutorial/14.lifecycle/1.Start-Stop.md

@@ -68,7 +68,7 @@ See also: [Endpoints](../7.endpoints/index) · [Logging](../5.logging/index)
 {: .fs-4 .fw-500}
 
 Previous: [Server Configuration](../13.server-configuration/index)
-Next: [Middleware](../15.middleware/index)
+Next: [Full Server Demo](./2.Full-Demo)
 
 [14.1-Start-Stop.ps1]: /pwsh/tutorial/examples/14.1-Start-Stop.ps1
 [Start-KrServer]: /pwsh/cmdlets/Start-KrServer

docs/pwsh/tutorial/14.lifecycle/2.Full-Demo.md

@@ -0,0 +1,75 @@
+---
+title: Full Server Demo
+parent: Lifecycle
+nav_order: 2
+layout: default
+---
+
+# Full Server Demo
+
+Run an integrated demo server with multiple endpoints, basic routes, and clean start/stop.
+
+## Full source
+
+File: [`pwsh/tutorial/examples/14.2-Full-Demo.ps1`][14.2-Full-Demo.ps1]
+
+```powershell
+{% include examples/pwsh/14.2-Full-Demo.ps1 %}
+```
+
+## Step-by-step
+
+1. Logging: Register a console logger.
+2. Certificates: Create (or reuse) a dev certificate for HTTPS.
+3. Server: Create a named server and add HTTP/HTTPS endpoints.
+4. Routes: Map a small set of demo routes (for example `/health` and `/version`).
+5. Lifecycle: Start non-blocking, wait for input, then stop and remove the server.
+
+## Try it
+
+```powershell
+# Run the demo (defaults to http://127.0.0.1:5000)
+pwsh .\docs\_includes\examples\pwsh\14.2-Full-Demo.ps1
+
+# In another terminal
+curl -i http://127.0.0.1:5000/health
+curl -i http://127.0.0.1:5000/version
+```
+
+## References
+
+- [New-KrServer][New-KrServer]
+- [Add-KrEndpoint][Add-KrEndpoint]
+- [Enable-KrConfiguration][Enable-KrConfiguration]
+- [Start-KrServer][Start-KrServer]
+- [Stop-KrServer][Stop-KrServer]
+- [Remove-KrServer][Remove-KrServer]
+- [New-KrSelfSignedCertificate][New-KrSelfSignedCertificate]
+- [Add-KrMapRoute][Add-KrMapRoute]
+
+## Troubleshooting
+
+| Symptom | Cause | Fix |
+|---|---|---|
+| HTTPS endpoint fails to start | Missing/incorrect PFX password | Re-run the script and enter the correct password when prompted |
+| Port already in use | Another process is listening on `$Port` | Stop the other process or run the script with `-Port` set to a free port |
+| Script waits for input | Demo uses a “press Enter to stop” pattern | Press Enter to stop, or remove the console read line if running non-interactively |
+
+---
+
+### Previous / Next
+
+{: .fs-4 .fw-500}
+
+Previous: [Start/Stop Patterns](./1.Start-Stop)
+Next: [Middleware](../15.middleware/index)
+
+[14.2-Full-Demo.ps1]: /pwsh/tutorial/examples/14.2-Full-Demo.ps1
+[New-KrServer]: /pwsh/cmdlets/New-KrServer
+[Add-KrEndpoint]: /pwsh/cmdlets/Add-KrEndpoint
+[Enable-KrConfiguration]: /pwsh/cmdlets/Enable-KrConfiguration
+[Start-KrServer]: /pwsh/cmdlets/Start-KrServer
+[Stop-KrServer]: /pwsh/cmdlets/Stop-KrServer
+[Remove-KrServer]: /pwsh/cmdlets/Remove-KrServer
+[New-KrSelfSignedCertificate]: /pwsh/cmdlets/New-KrSelfSignedCertificate
+[Add-KrMapRoute]: /pwsh/cmdlets/Add-KrMapRoute

docs/pwsh/tutorial/14.lifecycle/index.md

@@ -13,7 +13,8 @@ Chapters:
 | # | Chapter | Focus |
 |---|---------|-------|
 | 1 | [Start/Stop Patterns](./1.Start-Stop) | Blocking vs non‑blocking, programmatic stop |
+| 2 | [Full Server Demo](./2.Full-Demo) | Integrated demo scenario |
 
 See also: [Endpoints](../7.endpoints/index) · [Server Configuration](../13.server-configuration/index)
 
-Next: [Demos](../15.demos/index)
+Next: [Start/Stop Patterns](./1.Start-Stop)

docs/pwsh/tutorial/examples.zip

@@ -159,8 +159,8 @@ Static chapters and scripts are all linked directly above for quick navigation.
 [ch-auth-cookies]: ./8.authentication/5.Cookies
 [ch-auth-windows]: ./8.authentication/6.Windows-Authentication
 [ch-auth-claims]: ./8.authentication/7.Claims-Policies
-[ch-auth-multi-schemes]: ./8.authentication/8.Multiple-Schemes
-[ch-auth-full]: ./8.authentication/9.Full-Demo
+[ch-auth-multi-schemes]: ./8.authentication/10.Multiple-Schemes
+[ch-auth-full]: ./8.authentication/13.Full-Demo
 [ch-resp-text-json]: ./9.Responses/1.Basic-Text-Json
 [ch-resp-structured]: ./9.Responses/2.Structured-Xml-Yaml-Csv
 [ch-resp-binary]: ./9.Responses/3.Binary-Stream
@@ -176,7 +176,7 @@ Static chapters and scripts are all linked directly above for quick navigation.
 [ch-scfg-limits]: ./13.server-configuration/1.Server-Limits
 [ch-scfg-options]: ./13.server-configuration/2.Server-Options
 [ch-life-startstop]: ./14.lifecycle/1.Start-Stop
-[ch-demo-full]: ./17.demos/1.Full-Demo
+[ch-demo-full]: ./14.lifecycle/2.Full-Demo
 [ch-health-quick]: ./16.health/1.Health-Quickstart
 [ch-health-script]: ./16.health/2.Health-Script-Probe
 [ch-health-http]: ./16.health/3.Health-Http-Probe
@@ -193,7 +193,7 @@ Static chapters and scripts are all linked directly above for quick navigation.
 [ch-status-format]: /guides/statuscodepages
 [ch-status-redirects]: /guides/statuscodepages
 [ch-status-reexec]: /guides/statuscodepages
-[ch-mw-sessions]: ./19.Sessions/1.Sessions
+[ch-mw-sessions]: ./19.Sessions/1.Sessions-Basic
 [ch-mw-sessions-redis]: ./19.Sessions/2.Sessions-Redis
 [ch-mw-sessions-sql]: ./19.Sessions/3.Sessions-Sql
 [ch-localization]: ./21.Localization/1.Localization
@@ -230,7 +230,7 @@ Static chapters and scripts are all linked directly above for quick navigation.
 [sc-auth-windows]: /pwsh/tutorial/examples/8.6-Windows-Authentication.ps1
 [sc-auth-claims]: /pwsh/tutorial/examples/8.7-Claims-Policies.ps1
 [sc-auth-multi-schemes]: /pwsh/tutorial/examples/8.8-Multiple-Schemes.ps1
-[sc-auth-full]: /pwsh/tutorial/examples/8.9-Full-Demo.ps1
+[sc-auth-full]: /pwsh/tutorial/examples/8.12-Full-Demo.ps1
 [sc-resp-1]: /pwsh/tutorial/examples/9.1-Text-Json.ps1
 [sc-resp-2]: /pwsh/tutorial/examples/9.2-Structured-Xml-Yaml-Csv.ps1
 [sc-resp-3]: /pwsh/tutorial/examples/9.3-Binary-Stream.ps1
@@ -246,14 +246,14 @@ Static chapters and scripts are all linked directly above for quick navigation.
 [sc-scfg-limits]: /pwsh/tutorial/examples/13.1-Server-Limits.ps1
 [sc-scfg-options]: /pwsh/tutorial/examples/13.2-Server-Options.ps1
 [sc-life-startstop]: /pwsh/tutorial/examples/14.1-Start-Stop.ps1
-[sc-uploads-1]: /pwsh/tutorial/examples/22-file-and-form-uploads/22.1-Basic-Multipart.ps1
-[sc-uploads-2]: /pwsh/tutorial/examples/22-file-and-form-uploads/22.2-multiple-files.ps1
-[sc-uploads-3]: /pwsh/tutorial/examples/22-file-and-form-uploads/22.3-urlencoded.ps1
-[sc-uploads-4]: /pwsh/tutorial/examples/22-file-and-form-uploads/22.4-multipart-mixed.ps1
-[sc-uploads-5]: /pwsh/tutorial/examples/22-file-and-form-uploads/22.5-nested-multipart.ps1
-[sc-uploads-6]: /pwsh/tutorial/examples/22-file-and-form-uploads/22.6-request-compressed.ps1
-[sc-uploads-7]: /pwsh/tutorial/examples/22-file-and-form-uploads/22.7-part-compressed.ps1
-[sc-demo-full]: /pwsh/tutorial/examples/14.1-Full-Demo.ps1
+[sc-uploads-1]: /pwsh/tutorial/examples/22.1-Basic-Multipart.ps1
+[sc-uploads-2]: /pwsh/tutorial/examples/22.2-Multiple-Files.ps1
+[sc-uploads-3]: /pwsh/tutorial/examples/22.3-Url-Encoded.ps1
+[sc-uploads-4]: /pwsh/tutorial/examples/22.4-Multipart-Mixed.ps1
+[sc-uploads-5]: /pwsh/tutorial/examples/22.5-Nested-Multipart.ps1
+[sc-uploads-6]: /pwsh/tutorial/examples/22.6-Request-Compressed.ps1
+[sc-uploads-7]: /pwsh/tutorial/examples/22.7-Part-Compressed.ps1
+[sc-demo-full]: /pwsh/tutorial/examples/14.2-Full-Demo.ps1
 [sc-health-1]: /pwsh/tutorial/examples/16.1-Health-Quickstart.ps1
 [sc-health-2]: /pwsh/tutorial/examples/16.2-Health-Script-Probe.ps1
 [sc-health-3]: /pwsh/tutorial/examples/16.3-Health-Http-Probe.ps1
@@ -265,8 +265,8 @@ Static chapters and scripts are all linked directly above for quick navigation.
 [sc-sched-report]: /pwsh/tutorial/examples/12.3-Scheduling-Report.ps1
 [sc-status-1]: /pwsh/tutorial/examples/17.1-StatusCodePages-Default.ps1
 [sc-status-2]: /pwsh/tutorial/examples/17.2-StatusCodePages-Options.ps1
-[sc-status-3]: /pwsh/tutorial/examples/17.3-StatusCodePages-Handler.ps1
-[sc-status-4]: /pwsh/tutorial/examples/17.4-StatusCodePages-Script.ps1
+[sc-status-3]: /pwsh/tutorial/examples/17.3-StatusCodePages-CustomPowerShell.ps1
+[sc-status-4]: /pwsh/tutorial/examples/17.4-StatusCodePages-CustomCSharp.ps1
 [sc-status-5]: /pwsh/tutorial/examples/17.5-StatusCodePages-ContentFormat.ps1
 [sc-status-6]: /pwsh/tutorial/examples/17.6-StatusCodePages-Redirects.ps1
 [sc-status-7]: /pwsh/tutorial/examples/17.7-StatusCodePages-ReExecute.ps1