Cleans up the Examples in the repository, and adds them to the Documentation

[mdaneri]

Changes:

• Listener moved to localhost and port 8081 when possible,
• Import-Module generate an exception if fails
• Cleanup
• Tested
• Each Sample code include a .SYNOPSIS and .DESCRIPTION
• New autogenerate document page with all sample code under /docs/Getting-Started
• Pode.Build.ps1 automatically generate the sample code summary page
• New Pester test to check that any sample code includes .SYNOPSIS and .DESCRIPTION and .NOTE

Header Example

<#
.SYNOPSIS
    A sample PowerShell script to set up a Pode server and integrate with Redis for caching.
.DESCRIPTION
    This script sets up a Pode server listening on port 8081 with Redis integration for caching.
    It checks for the existence of the `redis-cli` command and sets up a Pode server with routes
    that demonstrate caching with Redis.
.NOTES
    Author: Pode Team
    License: MIT License
#>

[mdaneri]

I still need to do with this. I plan to make a change in Pode.build.ps1 to automatically create an MD document with any example with a brief description + a test to check if any example has the correct header for the build to generate the page. The Webhook sample is an example of what I mean

[Badgerati]

Aah I see, in a similar way to how the Function MDs are made with PlatyPS?

Couple of ideas, apologies if these are already planned! Would it be worth adding the following headers?

• .LINK, with a URL back to the example in GitHub
• .EXAMPLE, with how to invoke the script; which for most will likely just be some form of ./<file-name>.ps1

[mdaneri]

.LINK is available on the summary page .EXAMPLE do you think is really needed?