From f96e35b05bf63b5bfa86e8bffbcf57bbdb65fe5e Mon Sep 17 00:00:00 2001
From: Serge Bazanski <q3k@q3k.org>
Date: Fri, 18 Aug 2023 10:25:16 +0200
Subject: [PATCH] docs: mention new app directories

---
 docs/badge/programming.rst | 19 ++++++++++++++++---
 1 file changed, 16 insertions(+), 3 deletions(-)

diff --git a/docs/badge/programming.rst b/docs/badge/programming.rst
index e31ce4774..059893d89 100644
--- a/docs/badge/programming.rst
+++ b/docs/badge/programming.rst
@@ -597,9 +597,22 @@ Together with the Python code this file forms a so called bundle
 
 
 Save this as `flow3r.toml` together with the Python code as `__init__.py` in a
-folder (name doesn't matter) and put that folder into the ``/flash/sys/apps``
-folder on your flow3r (visible as ``sys/apps`` in `Disk Mode`_). Restart the
-flow3r and it should pick up your new application.
+folder (name doesn't matter) and put that folder into one of the possible
+application directories (see below) using `Disk Mode`_. Restart the flow3r and
+it should pick up your new application.
+
++--------+----------------------+---------------------+---------------------------------------+
+| Medium | Path in Disk Mode    | Path on Badge       | Notes                                 |
++========+======================+=====================+=======================================+
+| Flash  | ``sys/apps``         | ``/flash/sys/apps`` | “Default” apps.                       |
++--------+----------------------+---------------------+---------------------------------------+
+| Flash  | ``apps``             | ``/flash/apps``     | Doesn't exist by default. Split       |
+|        |                      |                     | from ``sys`` to allow for cleaner     |
+|        |                      |                     | updates.                              |
++--------+----------------------+---------------------+---------------------------------------+
+| SD     | ``apps``             | ``/sd/apps``        | Doesn't exist by default. Will be     |
+|        |                      |                     | retained even across badge reflashes. |
++--------+----------------------+---------------------+---------------------------------------+
 
 Distributing applications
 -------------------------
-- 
GitLab