📖 [Docs]: Fix Connect-Confluence examples to use -Site/-CloudId and align blog post scope

Author: MariusStorhaug

README.md

@@ -22,7 +22,7 @@ Connect with a scoped Atlassian API token, then call the resource commands. The
 ```powershell
 # Connect and store a reusable, named credential profile
 $token = Read-Host -AsSecureString   # a scoped Atlassian API token
-Connect-Confluence -ApiBaseUri 'https://api.atlassian.com/ex/confluence/<cloudId>' -Username 'you@example.com' -Token $token -SpaceKey 'DOCS'
+Connect-Confluence -Site 'yoursite' -Username 'you@example.com' -Token $token -SpaceKey 'DOCS'
 
 # Work with content
 $space = Get-ConfluenceSpace -Key 'DOCS'

examples/Connecting.ps1

@@ -16,11 +16,13 @@ Import-Module -Name 'Confluence'
 ###
 
 # Connect with a scoped Atlassian API token and store a reusable default profile.
+# -Site takes a subdomain, host, or any URL on the site and resolves the cloud ID for you.
 $token = Read-Host -AsSecureString   # a scoped Atlassian API token
-Connect-Confluence -ApiBaseUri 'https://api.atlassian.com/ex/confluence/<cloudId>' -Username 'you@example.com' -Token $token -SpaceKey 'DOCS'
+Connect-Confluence -Site 'yoursite' -Username 'you@example.com' -Token $token -SpaceKey 'DOCS'
 
 # Store several sites/accounts under explicit names and select per call.
-Connect-Confluence -ApiBaseUri 'https://api.atlassian.com/ex/confluence/<cloudId>' -Username 'you@example.com' -Token $token -Name 'sandbox'
+# If you already know the cloud ID, pass it directly with -CloudId to skip the lookup.
+Connect-Confluence -CloudId '<cloudId>' -Username 'you@example.com' -Token $token -Name 'sandbox'
 Get-ConfluenceSpace -Key 'DOCS' -Context 'sandbox'
 
 ###

src/functions/public/BlogPosts/Get-ConfluenceBlogPost.ps1

@@ -2,7 +2,7 @@
 function Get-ConfluenceBlogPost {
     <#
         .SYNOPSIS
-        Get blog posts (read:page).
+        Get blog posts (read:blogpost:confluence).
 
         .DESCRIPTION
         Returns a single blog post by id, the blog posts in a space, or all blog