Update docs

Author: aaronparker

docs/api.md

@@ -1,5 +1,11 @@
 # How to use the Evergreen API
 
+!!! warning
+
+    **The Evergreen API is provided free of charge - please don't abuse it**. The API is currently provided by the free tier of Cloudflare Workers which provides up to 100,000 total requests per day. The API is intended for development purposes only and not for use with distributed endpoints.
+    
+    If you encounter issues or would prefer to ensure data is only sourced from the application vendor, use `Get-EvergreenApp`.
+
 Evergreen's difference to other methods of finding and installing applications, is that Evergreen queries only official vendor sources when you use `Get-EvergreenApp`. This ensures that the information returned can be trusted because it comes from the vendor and is not crowd sourced.
 
 Evergreen supports [an API](https://evergreen-api.stealthpuppy.com/) that returns the same application version information as `Get-EvergreenApp`. The API supports the same applications as the Evergreen module because data is sourced via the module. The API runs on Cloudflare Workers with data that is updated every 8 hours.
@@ -8,9 +14,6 @@ Full documentation for the API is available here: [evergreen-api](https://app.sw
 
 Data that is returned by the Evergreen API can be viewed at the [Evergreen App Tracker](https://stealthpuppy.com/apptracker/).
 
-!!! attention "Attention"
-    Support for the Evergreen API is provided as a best effort. The API is currently provided by the free tier of Cloudflare Workers which provides up to 100,000 requests per day. If you encounter issues or would prefer to ensure data is only sourced from the application vendor, use `Get-EvergreenApp`.
-
 ## Usage
 
 In its current version, the API has only two endpoints that return data in JSON format - `/apps`, `/app/{appName}`. In PowerShell, the API can be queried with `Invoke-RestMethod`.

docs/endpoints.md

@@ -55,12 +55,12 @@ Application   Endpoints                                      Ports
 MicrosoftEdge {edgeupdates.microsoft.com, www.microsoft.com} {443}
 ```
 
-## Using Get-EvergreenEndpoint
+## Using Get-EvergreenEndpointFromApi
 
-`Get-EvergreenEndpoint` can be used to simplify usage of the API, by returning all endpoints used by Evergreen in a single object. Running `Get-EvergreenEndpoint` with no parameters, will return a complete list of endpoints and ports used for all applications.
+`Get-EvergreenEndpointFromApi` can be used to simplify usage of the API, by returning all endpoints used by Evergreen in a single object. Running `Get-EvergreenEndpointFromApi` with no parameters, will return a complete list of endpoints and ports used for all applications.
 
 ```powershell
-PS C:\> Get-EvergreenEndpoint
+PS C:\> Get-EvergreenEndpointFromApi
 
 Application          Endpoints                                                                              Ports
 -----------          ---------                                                                              -----
@@ -76,10 +76,10 @@ AdobeAcrobatReaderDC {acrobat.adobe.com, rdc.adobe.io, ardownload2.adobe.com}
 AdobeBrackets        {brackets.io, api.github.com, github.com}                                              {80, 443}
 ```
 
-`Get-EvergreenEndpoint` can return endpoints for a single application or an array of with the `-Name` parameter. In the example below `Get-EvergreenEndpoint` is used to return the endpoints and ports for the Microsoft Teams and Microsoft Edge endpoints.
+`Get-EvergreenEndpointFromApi` can return endpoints for a single application or an array of with the `-Name` parameter. In the example below `Get-EvergreenEndpointFromApi` is used to return the endpoints and ports for the Microsoft Teams and Microsoft Edge endpoints.
 
 ```powershell
-PS C:\> Get-EvergreenEndpoint -Name "MicrosoftTeams", "MicrosoftEdge"
+PS C:\> Get-EvergreenEndpointFromApi -Name "MicrosoftTeams", "MicrosoftEdge"
 
 Application    Endpoints                                                                              Ports
 -----------    ---------                                                                              -----
@@ -89,19 +89,19 @@ MicrosoftTeams {config.teams.microsoft.com, www.microsoft.com, statics.teams.cdn
 
 ### Return a simple list of all endpoints
 
-The output of `Get-EvergreenEndpoint` can be filtered to create a simple list of all unique endpoint URLs. The command below will generate an array of URLs that can then be used for an allow list of all endpoints required by Evergreen.
+The output of `Get-EvergreenEndpointFromApi` can be filtered to create a simple list of all unique endpoint URLs. The command below will generate an array of URLs that can then be used for an allow list of all endpoints required by Evergreen.
 
 ```powershell
-PS C:\> Get-EvergreenEndpoint | Select-Object -ExpandProperty "Endpoints" -Unique
+PS C:\> Get-EvergreenEndpointFromApi | Select-Object -ExpandProperty "Endpoints" -Unique
 ```
 
 ### Convert output to CSV
 
-The code below can be used to convert the output from `Get-EvergreenEndpoint` to a file in CSV format. The file will include the application name, endpoints URLs in a comma separated list, and ports in a comma separated list.
+The code below can be used to convert the output from `Get-EvergreenEndpointFromApi` to a file in CSV format. The file will include the application name, endpoints URLs in a comma separated list, and ports in a comma separated list.
 
 ```powershell
 $Path = "./Endpoints.csv"
-Get-EvergreenEndpoint | ForEach-Object {
+Get-EvergreenEndpointFromApi | ForEach-Object {
     [PSCustomObject]@{
         Application = $_.Application
         Endpoints   = $_.Endpoints -join ","

mkdocs.yml

@@ -146,10 +146,10 @@ nav:
   - Evergreen API:
     - How to use the Evergreen API: api.md
     - List endpoints used by Evergreen: endpoints.md
+  - Changelog: changelog.md
   - Resources:
     - Troubleshooting: troubleshoot.md
     - Known issues: issues.md
-    - Changelog: changelog.md
   - Module help:
     - en-US:
       - about_Evergreen: help/en-US/about_Evergreen.md