From 122bd3fcc1ce718a2273fc93808c0801929b31d1 Mon Sep 17 00:00:00 2001
From: David Rosa <rosatamsen@gmail.com>
Date: Thu, 25 May 2023 23:51:04 -0500
Subject: [PATCH] help: Add mobile instructions to "Share and upload files".

- Documents uploading files via compose box buttons.
- Documents sharing files from other Android apps.
---
 help/share-and-upload-files.md               |  49 ++++++++++++++++++-
 static/images/help/mobile-camera-icon.svg    | Bin 0 -> 340 bytes
 static/images/help/mobile-image-icon.svg     | Bin 0 -> 358 bytes
 static/images/help/mobile-paperclip-icon.svg | Bin 0 -> 331 bytes
 4 files changed, 47 insertions(+), 2 deletions(-)
 create mode 100644 static/images/help/mobile-camera-icon.svg
 create mode 100644 static/images/help/mobile-image-icon.svg
 create mode 100644 static/images/help/mobile-paperclip-icon.svg

diff --git a/help/share-and-upload-files.md b/help/share-and-upload-files.md
index 8675a5c5f9..5c91e0cb5b 100644
--- a/help/share-and-upload-files.md
+++ b/help/share-and-upload-files.md
@@ -23,6 +23,11 @@ and you can click on a thumbnail to [view the full image](/help/view-and-browse-
 
 1. _(optional)_ Modify the link text as desired.
 
+!!! tip ""
+
+    You can [preview the message](/help/preview-your-message-before-sending)
+    before sending to see what your uploaded files will look like.
+
 {tab|via-compose-box-buttons}
 
 {!start-composing.md!}
@@ -35,13 +40,53 @@ and you can click on a thumbnail to [view the full image](/help/view-and-browse-
 
 1. _(optional)_ Modify the link text as desired.
 
-{end_tabs}
-
 !!! tip ""
 
     You can [preview the message](/help/preview-your-message-before-sending)
     before sending to see what your uploaded files will look like.
 
+{tab|mobile}
+
+1. Navigate to a stream, topic, or direct message view.
+
+1. Tap the
+   **paperclip** (<img src="/static/images/help/mobile-paperclip-icon.svg" alt="paperclip" class="mobile-icon"/>),
+   **image** (<img src="/static/images/help/mobile-image-icon.svg" alt="image" class="mobile-icon"/>),
+   or **camera** (<img src="/static/images/help/mobile-camera-icon.svg" alt="camera" class="mobile-icon"/>)
+   button at the bottom of the app to select one or more files. Zulip will
+   upload the files, and insert named links using
+   [Markdown formatting](/help/format-your-message-using-markdown#links):
+   `[Link text](URL)`.
+
+1. _(optional)_ Modify the link text as desired.
+
+{end_tabs}
+
+!!! tip ""
+
+    The link text will default to the name of the uploaded file.
+
+## Sharing files
+
+You can share files from other apps on Zulip.
+
+{start_tabs}
+
+{tab|android}
+
+1. Select one or more files and tap the **Zulip**
+   (<img src="/static/images/logo/zulip-icon-circle.svg" alt="logo" class="mobile-icon"/>)
+   logo.
+
+1. Select a stream name and topic name, or tap the
+   **Direct message** tab and **Choose recipients**.
+
+1. _(optional)_ Write a message.
+
+1. Tap the **Send** button.
+
+{end_tabs}
+
 ## Named file example
 
 ### What you type
diff --git a/static/images/help/mobile-camera-icon.svg b/static/images/help/mobile-camera-icon.svg
new file mode 100644
index 0000000000000000000000000000000000000000..cf6d471ff5cefffc69a096a966809ba844ecb811
GIT binary patch
literal 340
zcmYjNO>e^>487-9Sl*e2n5bH(ki$;B?7BN5q|i}_NLsr6`Vp;bYgw}W-jlz&`Er2k
z$%k2@U6$#su5-?tEH*J6YT}&NMS*Z}Ccnq4L=GINEsiic?<Iy948pvm_+=!%Y}*};
z!#}{X8x|{(?tpi}Xf;Vp@f;qy6+T86?zr}9E<24zE!HHsMW)rsB!zti#k#4GFi89$
z0nJVkP}z<{!%DUn&o!gZ*GCP+$hMxCuv<?cZ2Qas{b1kKYxCP2?UMEebh*DNr|9nz
S1wxY8uF5~Uue$YDef0}ZL1Cc)

literal 0
HcmV?d00001

diff --git a/static/images/help/mobile-image-icon.svg b/static/images/help/mobile-image-icon.svg
new file mode 100644
index 0000000000000000000000000000000000000000..67d893780ab4ba98cd330afcb1ddd992079eae29
GIT binary patch
literal 358
zcmYL_O>V;=5JvYt#b~;Y`AHn5mGPoCu?RM_1T0KLa{CUclOhD8Pj7}N`t>@)?c&3#
z(B`~+Fjh)w%f5|iW|DKxh(NeHQ$FKOAqNifKpSCl-YX0-7=$&a_-z!v9S`qvIzNM5
zap!Cm%2(iBFnU}RruY;7xf*{(7hbvc<4R7G8M8GBwtMF;<7{wffL5Q3&OlCkg!|*%
zUK1w-Yus$J!dfR{$RH6Uap+m?+eT=Yv^SuMIJF&uCgxEjYNdeaKV;*V=<n4P7Lv^*
YC<TZP#1RCC4y33ZPiScR`g=q33$G(<v;Y7A

literal 0
HcmV?d00001

diff --git a/static/images/help/mobile-paperclip-icon.svg b/static/images/help/mobile-paperclip-icon.svg
new file mode 100644
index 0000000000000000000000000000000000000000..3282441eaad959086683c89bcfde5f35b9f896f1
GIT binary patch
literal 331
zcmYLF%Wi}q6y5t3H@9mL8OCTMF1qhW5XF&}0#Q25=NFtuZ^$7z4>-BQe!al$$GTnO
z8e@2`>y#2rC+fFL%^72Lb|74hP9OdzkpTlP@<CXPwGy3o8exx{|JD-UTG8`mei9^^
zIj$1<i?GJ&Nd<|U|8@VqLVtPVUi@U$o;xjC#Z_<cxJgh!Z<93v#|rWcA?q+p{NxQ4
z0-A=hvn4%kdMKb;Xmeu*4e6-p53ofzEJ}d5t8k`mdq4^EdzJ%#WI63lq=0?C(&0GN
M<@2!`%8JJ75B(lpZU6uP

literal 0
HcmV?d00001