diff --git a/docs/how-to/index.md b/docs/how-to/index.md index da37d5567..0e5725502 100644 --- 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 index 177584f0d..b26b417fd 100644 --- 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 ## 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: