From 9966dd66220ca3a8388bcee0dc405ce8cdaded62 Mon Sep 17 00:00:00 2001
From: zyphlar <zyphlar@users.noreply.github.com>
Date: Tue, 30 Jan 2024 09:09:40 -0800
Subject: [PATCH] Clarify github and go commands (#429)

- Git/GitHub require a protocol (https://) for clone.
- For non-Go users it's non-obvious where pebble gets installed and
  how to get it into your $PATH so some guidance there is nice.
---
 README.md | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index 10e8cb61..645468d1 100644
--- a/README.md
+++ b/README.md
@@ -66,22 +66,26 @@ correctly.
 
 ## Install
 
-1. [Set up Go](https://golang.org/doc/install). Add ~/go/bin to your $PATH, or
-   set GOBIN to a directory that is in your $PATH already.
-2. git clone github.com/letsencrypt/pebble/
-3. cd pebble
-4. go install ./cmd/pebble
+1. [Set up Go](https://golang.org/doc/install)
+2. Add `~/go/bin` to your $PATH, or set `GOBIN` to a directory that is in your
+   $PATH already, so that `pebble` will be in your $PATH for easy execution.
+   - One way to do this is to add `export PATH=$PATH:$HOME/go/bin` to your `~/.profile`
+4. git clone https://github.com/letsencrypt/pebble/
+5. cd pebble
+6. go install ./cmd/pebble
 
 ## Usage
 
 ### Binary
 
-Assuming pebble is in your $PATH:
+Assuming pebble is easily accessible in your $PATH:
 
 ```bash
 pebble -config ./test/config/pebble-config.json
 ```
 
+(otherwise replace `pebble` with `~/go/bin/pebble` or `$GOBIN/pebble`)
+
 Afterwards you can access the Pebble server's ACME directory
 at `https://localhost:14000/dir`.