docs: suggestions from Ben

canonical · Nov 26, 2024 · e90e04e · e90e04e
1 parent 63f2e8b
commit e90e04e
Show file tree

Hide file tree

Showing 2 changed files with 4 additions and 4 deletions.
diff --git a/docs/how-to/index.md b/docs/how-to/index.md
@@ -1,11 +1,11 @@
 # How-to guides
 
-These guides walk you through the operations lifecycle of Pebble.
+These guides walk you through key operations you can perform with Pebble.
 
 
 ## Installation
 
-Installation follows a broadly similar pattern on all architectures. You can choose to install the pre-built binary or build it from the source by yourself.
+Installation follows a similar pattern on all architectures. You can choose to install the pre-built binary or build it from the source by yourself.
 
 ```{toctree}
 :titlesonly:

diff --git a/docs/reference/index.md b/docs/reference/index.md
@@ -5,7 +5,7 @@ These guides provide technical information about Pebble.
 
 ## Layers
 
-Your service configuration is defined as a stack of "layers".
+Pebble configuration is defined as a stack of "layers".
 
 ```{toctree}
 :titlesonly:
@@ -30,7 +30,7 @@ CLI Commands <cli-commands/cli-commands>
 
 ## Pebble in containers
 
-When Pebble is configured as a client connected to a remote system (e.g., a separate container), you can use subcommands on the client to manage the remote system.
+When Pebble is configured as a client connected to a remote system (for example, a separate container), you can use subcommands on the client to manage the remote system.
 
 ```{toctree}
 :titlesonly: