diff --git a/README.md b/README.md
index 934243d..39029a3 100644
--- a/README.md
+++ b/README.md
@@ -44,8 +44,8 @@ Additionally, `echo` now has a `-p` flag that expands prompt escape sequences, s
 
 `shed` comes with fuzzy completion and history searching out of the box. It has it's own internal fuzzyfinder implementation, so `fzf` is not a dependency.
 
-<img width="773" height="505" alt="shed_comp" src="https://github.com/user-attachments/assets/d317387e-4c33-406a-817f-1c183afab749" />
-<img width="773" height="536" alt="shed_search" src="https://github.com/user-attachments/assets/5109eb14-5c33-46bb-ab39-33c60ca039a8" />
+<img width="380" height="270" alt="shed_comp" src="https://github.com/user-attachments/assets/d317387e-4c33-406a-817f-1c183afab749" />
+<img width="380" height="270" alt="shed_search" src="https://github.com/user-attachments/assets/5109eb14-5c33-46bb-ab39-33c60ca039a8" />
 
 
 ### Keymaps
diff --git a/examples/surround_plugin.sh b/examples/surround_plugin.sh
index 7672cc4..ab2a4a7 100644
--- a/examples/surround_plugin.sh
+++ b/examples/surround_plugin.sh
@@ -1,3 +1,7 @@
+# An implementation of the 'nvim-surround' plugin by kylechui
+# that uses shed's keymap system to alter line editor state
+
+
 _get_surround_target() {
 	# get the delimiters to surround our selection with
 	read_key -v _s_ch