docs(polykey): refine identity authentication and claim process details

Update the documentation to enhance clarity and accuracy in the identity authentication and claim sections. Include detailed command usage, provide examples for verifying authenticated identities, and adjust the descriptions to better explain the management of multiple identities across nodes and IdPs. Improve navigational instructions for gist verification and incorporate feedback on security and privacy considerations.

Author: CryptoTotalWar

docs/tutorials/polykey-cli/claiming-digital-identities.md

@@ -38,6 +38,23 @@ This command begins the authentication process with GitHub. Follow the prompts i
 The code prompted by the browser will be displayed in your terminal as the user code.
 :::
 
+### Lists all authenticated identities across all providers
+
+`polykey identities authenticated` command will output the providerID and corresponding identityID of the authenticated IdP. This is a way to check that you completed the authentication process correctly.
+
+#### Example Usage
+
+```bash
+polykey identities authenticated
+```
+
+##### Example Output
+
+```bash
+providerId	github.com
+identityId	maverick
+```
+
 ### Technical Use of Permissions
 
 During the authentication process, here's what Polykey requests access to and why:
@@ -86,26 +103,14 @@ _This image shows a demo example of the link to the gist that was created when c
 
 ### Primary Verification Method
 
-Navigate directly to the provided gist link:
+Check your GH gists. Replace `my-github-username` with your actual gh username and navigate to the url.
 
 ```bash
 https://gist.github.com/my-github-username
 ```
 
 This gist contains the cryptographic link confirming that your Polykey identity is correctly linked to your GitHub profile. Viewing this gist ensures your claim was successful and publicly verifiable.
 
-### Additional Verification Options
-
-While navigating to the gist is sufficient for most users, Polykey also offers ways to internally verify the identity claim:
-
-- **Polykey Gestalt List:** You can list all gestalts, including your own, to see the internal record of your claim.
-
-```bash
-polykey identities list
-```
-
-This command shows details about your claimed identities and connected nodes, providing an extra layer of verification.
-
 ## Understanding Gestalt Graphs
 
 In Polykey, claiming identities creates a **gestalt graph**—a dynamic, interconnected network of your digital identities across various platforms. This graph facilitates the federated identity model, allowing for more robust and streamlined identity verification and management.

docs/tutorials/polykey-cli/discovering-other-users.md

@@ -1,2 +1 @@
-
-# Discovering Other Users
+# Discovering Users' Nodes and Managing Access Permissions