diff --git a/docs/methods/auth.signIn.md b/docs/methods/auth.signIn.md
index e69de29..e8bcdf9 100644
--- a/docs/methods/auth.signIn.md
+++ b/docs/methods/auth.signIn.md
@@ -0,0 +1 @@
+This method is used to authenticate an existing Telegram user. If the user needs to register an account, they should use [auth.signUp](#!/method/auth.signUp) to register their number with the system.
\ No newline at end of file
diff --git a/docs/methods/auth.signUp.md b/docs/methods/auth.signUp.md
index e69de29..211a0ed 100644
--- a/docs/methods/auth.signUp.md
+++ b/docs/methods/auth.signUp.md
@@ -0,0 +1 @@
+This method is used to register a new Telegram user. If their phone number is already in the Telegram system (e.g. they already have an account), they should use [auth.signIn](#!/method/auth.signIn)
\ No newline at end of file