diff --git a/doc/source/admin/appdev-guide/step-by-step/part1.rst b/doc/source/admin/appdev-guide/step-by-step/part1.rst
index dd8b3a9c4..39301a1a7 100644
--- a/doc/source/admin/appdev-guide/step-by-step/part1.rst
+++ b/doc/source/admin/appdev-guide/step-by-step/part1.rst
@@ -56,6 +56,8 @@ domain-specific prefix.
 Murano, while a ``Library`` is  bundle of reusable scenarios which may be used
 by other packages. For now we just need a single standalone app, so let's
 choose an ``Application`` type.
+The ``Description`` is a text attribute, providing detailed info about your
+package.
 
 Enter these values and save the file. You should have something like this:
 
@@ -64,7 +66,10 @@ Enter these values and save the file. You should have something like this:
 
    FullName: com.yourdomain.HelloWorld
    Type: Application
-
+   Description: |
+       A package which demonstrates
+       development for Murano
+       by greeting the user.
 
 This is the minimum required to start. We'll add more manifest data later.
 
diff --git a/doc/source/admin/appdev-guide/step-by-step/part2.rst b/doc/source/admin/appdev-guide/step-by-step/part2.rst
index 5af0c4bed..346c2bcb0 100644
--- a/doc/source/admin/appdev-guide/step-by-step/part2.rst
+++ b/doc/source/admin/appdev-guide/step-by-step/part2.rst
@@ -392,6 +392,10 @@ part contained only mandatory fields. This is how it should look by now:
 
    FullName: com.yourdomain.HelloWorld
    Type: Application
+   Description: |
+      A package which demonstrates
+      development for Murano
+      by greeting the user.
    Classes:
      com.yourdomain.HelloWorld: HelloWorld.yaml
 
@@ -401,9 +405,6 @@ First, you can add a ``Name`` attribute. Unlike ``FullName``, it is not a
 unique identifier of the package. But, if specified, it overrides the name of
 the package that is displayed in the catalog.
 
-Then there is a ``Description`` field. This is a multi-line text attribute,
-providing detailed info about your package.
-
 Then an ``Author`` field: here you can put your name or the name of your
 company, so it will be displayed in catalog as the name of the package
 developer. If this field is omitted, the catalog will consider the package to