tutorials: handle "registering a device" confusion

vanmaegima · vanmaegima · commit ec01ec121f07 · 2026-03-06T11:43:11.000-03:00
Now that we support container-only factories, the registering process is specific for
the factory type.

We should point to both sources when mentioning the registered devices.

Signed-off-by: Vanessa Maegima &lt;vanessa.maegima@foundries.io&gt;
diff --git a/source/getting-started/fioup-registration/index.rst b/source/getting-started/fioup-registration/index.rst
@@ -1,3 +1,5 @@
+.. _gs-register-fioup:
+
 Registering Your Device with Fioup
 ==================================
 
diff --git a/source/tutorials/creating-first-target/creating-first-target.rst b/source/tutorials/creating-first-target/creating-first-target.rst
@@ -24,6 +24,13 @@ Prerequisites
 
 - Completed the :ref:`tutorial-gs-with-docker` tutorial.
 - Completed the :ref:`gs-install-fioctl` section.
+
+For **Arduino UNO Q** and **Container-Only** Factories:
+
+- Completed the :ref:`gs-register-fioup` section.
+
+For **LmP** Factories:
+
 - Completed the :ref:`gs-flash-device` section.
 - Completed the :ref:`gs-register` section.
 
diff --git a/source/tutorials/creating-first-target/what-is-a-target.rst b/source/tutorials/creating-first-target/what-is-a-target.rst
@@ -25,7 +25,11 @@ Devices configured to watch a tag and Hardware ID (``MACHINE``) that match your
 
 .. note::
 
-   At this point, your device should be registered, as covered in the :ref:`Getting Started guide <gs-register>`.
+   At this point, your device should be registered, as covered in:
+
+   - :ref:`gs-register-fioup` for **Arduino UNO Q** and **Container-Only** Factories, or
+   - :ref:`gs-register` for **LmP** Factories.
+
    If your device is online, it will automatically receive an update with your latest **Target**.
    The next tutorial will cover this in detail.
 
diff --git a/source/tutorials/customizing-the-platform/customizing-the-platform.rst b/source/tutorials/customizing-the-platform/customizing-the-platform.rst
@@ -3,6 +3,13 @@
 Customizing the Platform
 ========================
 
+.. important::
+
+   This covers **LmP** platform customization.
+   This is suitable for **LmP**-based Factories, which include the ``meta-subscriber-overrides.git`` and ``lmp-manifest.git`` repositories.
+
+   **Arduino UNO Q** and **Container-Only** users should skip this tutorial.
+
 Docker Compose Apps are the recommended way to create applications.
 However, you are also allowed to customize and change the platform when needed.
 
@@ -47,6 +54,7 @@ Learning Objectives
 Prerequisites
 -------------
 
+- Have a **LmP**-based Factory.
 - Completed the Getting Started guide up through :ref:`gs-register`.
 - Read the :ref:`ref-linux` reference manual.
 
diff --git a/source/tutorials/deploying-first-app/configure-your-device.rst b/source/tutorials/deploying-first-app/configure-your-device.rst
@@ -1,7 +1,15 @@
 Configure Your Device
 ^^^^^^^^^^^^^^^^^^^^^
 
-Your device should be registered to your Factory according to the :ref:`Getting Started guide <gs-register>`.
+Your device should be registered to your Factory.
+
+.. tip::
+
+   You can register your device following:
+
+   - :ref:`gs-register-fioup`, for **Arduino UNO Q** and **Container-Only** Factories, or
+   - :ref:`gs-register`, for **LmP** Factories
+
 Once registered, two services start to communicate with a Factory: ``aktualizr-lite`` and ``fioconfig``.
 
 **aktualizr-lite**:
diff --git a/source/tutorials/getting-started-with-docker/gs-summary.rst b/source/tutorials/getting-started-with-docker/gs-summary.rst
@@ -6,9 +6,11 @@ The FoundriesFactory™ Platform CI will build and deploy this app as a **Target
 
 .. important::
 
-  If you followed this tutorial before flashing and registering your device, 
+  The following tutorials require a device registered to the Factory.
+
+  If you followed this tutorial before registering your device,
   return to the ``Getting Started`` section and complete the following:
 
-   - :ref:`gs-flash-device`.
-   - :ref:`gs-register`.
+  - :ref:`gs-register-fioup`, for **Arduino UNO Q** and **Container-Only** Factories, or
+  - :ref:`gs-flash-device` and :ref:`gs-register`, for **LmP** Factories.
 
diff --git a/source/tutorials/index.rst b/source/tutorials/index.rst
@@ -7,7 +7,7 @@ The following tutorials will help familiarize you with the workflow for your Fac
 As the concepts build upon others, follow them sequentially.
 
 .. important::
-   The tutorials assume you have followed the Getting Started and that you have a :ref:`registered device <gs-register>`.
+   The tutorials assume you have followed the Getting Started and that you have a registered device for either a :ref:`Arduino UNO Q / Container-Only Factory <gs-register-fioup>` or a :ref:`LmP Factory <gs-register>`.
 
    Make sure you have ``git`` and :ref:`Fioctl <gs-install-fioctl>` installed on your host machine.
    ``QEMU`` is also required if it is set in your Factory.
diff --git a/source/tutorials/working-with-tags/working-with-tags.rst b/source/tutorials/working-with-tags/working-with-tags.rst
@@ -41,8 +41,12 @@ Learning Objectives
 Prerequisites
 -------------
 
-- Completed the Getting Started guide up through :ref:`gs-register`.
+- Completed the Getting Started.
 - Completed the :ref:`tutorial-creating-first-target` tutorial.
+- Registered a device following:
+
+  - :ref:`gs-register-fioup`, for **Arduino UNO Q** and **Container-Only** Factories, or
+  - :ref:`gs-flash-device` and :ref:`gs-register`, for **LmP** Factories.
 
 Instructions
 ------------

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,5 @@`
	`1`	`+.. _gs-register-fioup:`
	`2`	`+`
`1`	`3`	`Registering Your Device with Fioup`
`2`	`4`	`==================================`
`3`	`5`