diff --git a/charm/docs/how-to/manage-domains.md b/charm/docs/how-to/manage-domains.md
index 2b58705..958434b 100644
--- a/charm/docs/how-to/manage-domains.md
+++ b/charm/docs/how-to/manage-domains.md
@@ -14,4 +14,9 @@ Run
 
 ## Listing domains
 To query the list of allowed domains for a user, run
-`juju run --wait=5s httprequest-lego-provider/0 list-domains username=example"`.
+`juju run --wait=5s httprequest-lego-provider/0 list-domains username=example`
+and the list of domains will be returned as in
+```bash
+result: |
+  _acme-challenge.example.domain.com, _acme-challenge.example2.domain.com
+```
diff --git a/charm/docs/how-to/manage-users.md b/charm/docs/how-to/manage-users.md
index 7ec39fb..33d2fad 100644
--- a/charm/docs/how-to/manage-users.md
+++ b/charm/docs/how-to/manage-users.md
@@ -1,6 +1,10 @@
 # How to manage users
 
 Users will be leveraged to determine if a request is authorised to manage a specific domain. To add a new user simply run 
-`juju run --wait=5s httprequest-lego-provider/0 create-user username=example-user`. The action will generate and output a password.
+`juju run --wait=5s httprequest-lego-provider/0 create-user username=example-user`. The action will generate and output a password:
+```bash
+result: |
+  Created or updated "example" with password "**REDACTED**"
+```
 
 If the action is rerun, a new password will be generated.