branding docs improvements (#333)

Co-authored-by: Rita Zerrizuela <[email protected]>
auth0 · Jul 12, 2021 · 25196bd · 25196bd
1 parent 27afbb7
commit 25196bd
Show file tree

Hide file tree

Showing 3 changed files with 16 additions and 1 deletion.
diff --git a/docs/images/templates-storybook.png b/docs/images/templates-storybook.png
diff --git a/docs/images/templates-vs-code.png b/docs/images/templates-vs-code.png
diff --git a/internal/cli/branding.go b/internal/cli/branding.go
@@ -92,7 +92,22 @@ func templateCmd(cli *cli) *cobra.Command {
 	cmd := &cobra.Command{
 		Use:   "templates",
 		Short: "Manage custom page templates",
-		Long:  "Manage custom page templates. This requires at least one custom domain to be configured for the tenant.",
+		Long:  `Manage custom [page templates](https://auth0.com/docs/universal-login/new-experience/universal-login-page-templates). This requires a custom domain to be configured for the tenant.
+
+This command will open two windows:
+
+* A browser window with a [Storybook](https://storybook.js.org/) that shows the login page with the page template applied:
+
+![storybook](images/templates-storybook.png)
+
+* The default terminal editor, with the page template code:
+
+![storybook](images/templates-vs-code.png)
+
+You now change the page template code, and the changes will be reflected in the browser window. 
+
+Once you close the window, you’ll be asked if you want to save the template. If you answer Yes, the template will be uploaded to your tenant.
+`,
 	}
 
 	cmd.SetUsageTemplate(resourceUsageTemplate())