diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
new file mode 100644
index 00000000..e4369d07
--- /dev/null
+++ b/.github/pull_request_template.md
@@ -0,0 +1,12 @@
+
+## What did you change
+
+
+## Why did you change it
+
+
+## Screenshots
+### Before
+
+
+### After
diff --git a/docs/software/android/usage.mdx b/docs/software/android/usage.mdx
index 1e9acea8..a2dc83a8 100644
--- a/docs/software/android/usage.mdx
+++ b/docs/software/android/usage.mdx
@@ -4,6 +4,9 @@ title: Android Application Usage
sidebar_label: Usage
sidebar_position: 2
---
+import Link from "@docusaurus/Link"
+import ThemedImage from '@theme/ThemedImage';
+import useBaseUrl from '@docusaurus/useBaseUrl';
## Introduction
@@ -35,11 +38,35 @@ To find devices to connect via Bluetooth click the "+" button on the bottom righ
The cloud icon at the top right corner indicates if you are connected to a device. This currently has three states:
- Cloud with a slash through it: No device connected to the application.
+
+
+
+Cloud with a slash through it: No device connected to the application.
- Cloud with a tick in it: Device connected to the application.
+
+
+
+Cloud with a check in it: Device connected to the application.
- Cloud with an up arrow in it: Device is connected, but currently sleeping or out of range.
+
+
+
+Cloud with an up arrow in it: Device is connected, but currently sleeping or out of range.
## Common tasks
@@ -126,17 +153,61 @@ The message window operates like most messaging apps. Note that your primary cha
With LoRa (or any radio) there is some uncertainty that the message has been received, so there is a confirmation built-in to the protocol. There are small icons shown to the right of the messages you send:
-- Cloud with an up arrow: the message is queued in the app, waiting to be handed to the device.
+
+
+
+Cloud with an up arrow: the message is queued in the app, waiting to be handed to the device.
+
+
+
+
- Cloud only: the device received the message from the app, and it has been sent and transmitted via LoRa.
+
+
+
+
- Cloud with a check mark: received at least one node's acknowledgement response. Confirmations could be from any one device.
+
+
+
+
- Person with a check mark - The intended recipient node of your direct message acknowledged the message.
+
+
+
+
- Cloud crossed out: the initial sender did not receive any confirmation within a certain timeout.
By default there is no long-term store-and-forward of messages, so messages not received during transmission are lost.
### View your network
-[](/img/android/android-nodes.webp)
+](/img/android/android-nodes.webp)
The network list shows all the users (devices) that have connected to the same Channel. For each entry, it shows the last time they were active, their location and distance (when available), and their last known power status. In the example above, Monkey is the local user, Rabbit was last heard from 10 minutes ago and is 50m away, and Panda was last heard 11 minutes ago and 5m away.
diff --git a/static/img/android/android-DM-ack_dk.webp b/static/img/android/android-DM-ack_dk.webp
new file mode 100644
index 00000000..34696ad2
Binary files /dev/null and b/static/img/android/android-DM-ack_dk.webp differ
diff --git a/static/img/android/android-DM-ack_lt.webp b/static/img/android/android-DM-ack_lt.webp
new file mode 100644
index 00000000..f4760f3f
Binary files /dev/null and b/static/img/android/android-DM-ack_lt.webp differ
diff --git a/static/img/android/android-imp-ack_dk.webp b/static/img/android/android-imp-ack_dk.webp
new file mode 100644
index 00000000..f31524e6
Binary files /dev/null and b/static/img/android/android-imp-ack_dk.webp differ
diff --git a/static/img/android/android-imp-ack_lt.webp b/static/img/android/android-imp-ack_lt.webp
new file mode 100644
index 00000000..48e1a114
Binary files /dev/null and b/static/img/android/android-imp-ack_lt.webp differ
diff --git a/static/img/android/android-no-ack_dk.webp b/static/img/android/android-no-ack_dk.webp
new file mode 100644
index 00000000..babe54a9
Binary files /dev/null and b/static/img/android/android-no-ack_dk.webp differ
diff --git a/static/img/android/android-no-ack_lt.webp b/static/img/android/android-no-ack_lt.webp
new file mode 100644
index 00000000..2b88668d
Binary files /dev/null and b/static/img/android/android-no-ack_lt.webp differ
diff --git a/static/img/android/android-sent_dk.webp b/static/img/android/android-sent_dk.webp
new file mode 100644
index 00000000..aa314945
Binary files /dev/null and b/static/img/android/android-sent_dk.webp differ
diff --git a/static/img/android/android-sent_lt.webp b/static/img/android/android-sent_lt.webp
new file mode 100644
index 00000000..871396f6
Binary files /dev/null and b/static/img/android/android-sent_lt.webp differ
diff --git a/static/img/android/android-waiting_dk.webp b/static/img/android/android-waiting_dk.webp
new file mode 100644
index 00000000..a0a72463
Binary files /dev/null and b/static/img/android/android-waiting_dk.webp differ
diff --git a/static/img/android/android-waiting_lt.webp b/static/img/android/android-waiting_lt.webp
new file mode 100644
index 00000000..fcfd161b
Binary files /dev/null and b/static/img/android/android-waiting_lt.webp differ