Document custom project names and labels

doc/_toc.yml

@@ -13,6 +13,7 @@ parts:
       - file: user-guide/github
       - file: user-guide/env-vars
       - file: user-guide/custom-domains
+      - file: user-guide/managing-apps
 
   - caption: Sharing notebooks
     chapters:

doc/user-guide/custom-domains.md

@@ -1,9 +1,28 @@
-# Custom domains
+# Custom domains and subdomains
 
 When you publish your application for the first time, your web address (i.e., URL) is in the following format: `project-id.plooberapp.io`
 
+Ploomber offers options to customize the [subdomain](#custom-subdomain) or the [full domain](#custom-domain).
+
 If you already own a domain, you can easily bring it to your Ploomber account by updating your DNS records, or by changing its nameservers.
 
+(custom-subdomain)=
+## Adding a custom subdomain
+
+```{note}
+Custom project names are a [paid feature.](../pricing/overview.md)
+```
+
+If you would like a custom subdomain, like `my-custom-app.ploomberapp.io`, you can add a custom name during application setup:
+
+![](../static/custom-domains/custom-names.png)
+
+Customizing the project name only changes the `x` portion in `x.ploomberapp.io`.
+
+If you would like a fully customized domain, see [Adding a custom domain](#custom-domain).
+
+
+(custom-domain)=
 ## Adding a custom domain
 
 ### Before you begin

doc/user-guide/managing-apps.md

@@ -0,0 +1,17 @@
+# Managing applications
+
+## Labels
+
+Labels can help you organize and identify your apps. You can add them during creation:
+
+![](../static/manage-apps/labels.png)
+
+Or add them from the application status page:
+
+![](../static/manage-apps/add-label-from-status.png)
+
+You may add as many labels as you want. Once you've added some labels, they will show up on the status page and the main Applications page:
+
+![](../static/manage-apps/see-labels-status.png)
+
+![](../static/manage-apps/see-labels-main.png)