Move custom-app document to the how-to section (#572)

* Move custom-app document to how-to section Fix: CHECKBOX-671 * Update reference to the custom-app doc * Fix broken reference
canonical · Jun 27, 2023 · 5cad2ae · 5cad2ae
1 parent e4fae42
commit 5cad2ae
Show file tree

Hide file tree

Showing 5 changed files with 4 additions and 4 deletions.
diff --git a/docs/tutorial/custom-app.rst → docs/how-to/custom-app.rst b/docs/tutorial/custom-app.rst → docs/how-to/custom-app.rst
diff --git a/docs/how-to/index.rst b/docs/how-to/index.rst
@@ -8,6 +8,7 @@ These how-to guides cover key operations and processes in Checkbox.
 
    using
    testing-ubuntu-core
+   custom-app
    nested-test-plan
    side-loading
    slave-daemon
diff --git a/docs/reference/units/category.rst b/docs/reference/units/category.rst
@@ -7,8 +7,8 @@ Using category units one can define logical groups of tests that deal with some
 specific testing area (for example, suspend-resume or USB support).
 
 Job definitions can be associated with at most one category using the
-``category_id`` field (see :ref:`job unit reference <category_id>`). Categories
-can be used by particular applications to facilitate test selection.
+``category_id`` field (see :ref:`job unit reference <Category id field>`).
+Categories can be used by particular applications to facilitate test selection.
 
 Category Fields
 ---------------

diff --git a/docs/tutorial/index.rst b/docs/tutorial/index.rst
@@ -27,7 +27,6 @@ journey through the product.
    :maxdepth: 1
 
    tutorial
-   custom-app
 
 Extended tutorial
 -----------------

diff --git a/docs/tutorial/tutorial.rst b/docs/tutorial/tutorial.rst
@@ -5,7 +5,7 @@ Checkbox tutorials
 
 .. note::
     If you're planning to develop tests for a Ubuntu Core system or
-    planning to package your tests as a Snap, see :doc:`custom-app`.
+    planning to package your tests as a Snap, see :doc:`/how-to/custom-app`.
 
 Creating an empty provider
 --------------------------