Make documentation standalone and generalize examples

backend/fluksio/api/socket_auth.py

@@ -50,7 +50,7 @@ def socket_token(headers: Mapping[str, str], ticket: str = "", token: str = "")
 
     `token` is the query parameter clients sent before the other two existed.
     It is read for one more release so an engine can be upgraded before its
-    workers; remove it after that (see NOTEPAD).
+    workers. New clients should use the Authorization header.
     """
     header = headers.get("authorization") or ""
     if header.lower().startswith("bearer "):