From 10b53282470343176a13c64e81a5bb24c37dab97 Mon Sep 17 00:00:00 2001
From: April John <30842467+CutestNekoAqua@users.noreply.github.com>
Date: Tue, 19 Nov 2024 19:19:16 +0000
Subject: [PATCH] fix: update Versia Links

---
 app/links/page.mdx | 24 ++++++++++++++----------
 1 file changed, 14 insertions(+), 10 deletions(-)

diff --git a/app/links/page.mdx b/app/links/page.mdx
index c52940e..7d57ec5 100644
--- a/app/links/page.mdx
+++ b/app/links/page.mdx
@@ -18,20 +18,22 @@ Versia Links are a way to reference entities in the Versia Protocol, in a way th
 
                 An IANA registration for the `versia://` scheme will be requested in the future.
             </Property>
-            <Property name="instance" type="string" required={true}>
-                Instance host, including the port if it is not the default (i.e. `443` for HTTPS).
-            </Property>
             <Property name="action" type="string" required={true}>
                 Action to take on the entity. Can have multiple slashes as a way to segment the action.
+                Links that reference instance-specific content (like Entities) **must** reference a Instance.
 
                 Possible actions:
 
-                - `users/:username`: Open a user profile.
-                - `notes/:id`: Open a note.
-                - `groups/:id`: Open a group.
-                - `reply/:id`: Open the composer to reply to a note.
-                - `quote/:id`: Open the composer to quote a note.
-                - `share/:id`: Share a note.
+                - `users/:instance/:id`: Open a user profile.
+                - `notes/:instance/:id`: Open a note.
+                - `groups/:instance/:id`: Open a group.
+                - `reply/:instance/:id`: Open the composer to reply to a note.
+                - `quote/:instance/:id`: Open the composer to quote a note.
+                - `share/:instance/:id`: Share a note.
+                - `compose/:text`: Compose a new note. Text passed at the end will be added in the note compose field. Used for "Share with Versia" buttons on websites.
+            </Property>
+            <Property name="instance" type="string" required={false}>
+                Instance hosting the referenced content, including the port if it is not the default (i.e. `443` for HTTPS).
             </Property>
         </Properties>
     </Col>
@@ -60,4 +62,6 @@ The default client ("frontend") on a Versia instance **should** also display Ver
 - Notes
 - Groups
 
-Clients **should** ask users to confirm any action that is not a simple view action, such as replying to a note or sharing a note.
\ No newline at end of file
+This **could** be used for easier following of users from remote instances.
+
+Clients **should** ask users to confirm any action that is not a simple view action, such as replying to a note or sharing a note.