diff --git a/recipe.yml b/recipe.yml
index ed41444..2a8e8e3 100644
--- a/recipe.yml
+++ b/recipe.yml
@@ -1,27 +1,28 @@
-# the image will be at ghcr.io/yourusername/name
+# The image will be at ghcr.io/yourusername/name
 name: startingpoint
 
-# what native container image to build on top of
-# images not built by ublue might function unexpectly
+# The native container image to build on top of
+# images. 
+# Warning: Non-uBlue images might function unexpectly
 base-container: ghcr.io/ublue-os/silverblue-main
 
-# what fedora version to use, you can just change this to the next version update
-# if you change this to "latest", you will be automatically updated
+# What fedora version to use. Use an explicit version or `latest`.
+# If you use `latest`, you will be automatically updated
 # to the next major version assuming the image you're using as your base container
-# builds with the tag (all uBlue images do)
+# builds with the tag (all uBlue images do this). 
 fedora-version: 37
 
-# this description will be visible in the containers metadata
+# This description will be visible in the container metadata
 description: A starting point for further customization of uBlue images. Make your own! https://ublue.it/making-your-own/
 
-# these rpms will be installed from the fedora repository
+# These rpms will be installed from the fedora repository
 # using rpm-ostree and will be preinstalled in the final image
 rpms:
   - python3-pip # needed for yafti (the first boot installer)
 
-# these flatpaks (from flathub) will be available for install on boot
-# this is just an example selection, and even if you leave it empty,
-# you'll have the basic options available in yafti
+# These Flatpaks (from flathub) will be available for install on boot
+# this is just an example selection.
+# If you leave this empty you can use yafti for post-boot installation
 flatpaks:
   - org.mozilla.firefox
   - org.mozilla.Thunderbird