diff --git a/Containerfile b/Containerfile
index 7387857..0769943 100644
--- a/Containerfile
+++ b/Containerfile
@@ -1,19 +1,24 @@
 ARG FEDORA_MAJOR_VERSION=37
 
+# change this line if you want to change the image
 FROM ghcr.io/ublue-os/silverblue-main:${FEDORA_MAJOR_VERSION}
 
+# copy over configuration files
 COPY etc /etc
 # COPY usr /usr
 
 COPY ublue-firstboot /usr/bin
 COPY recipe.yml /etc/ublue-recipe.yml
 
+# yq used in build.sh and the setup-flatpaks recipe to read the recipe.yml
+# copied from the official container image as it's not avaible as an rpm
 COPY --from=docker.io/mikefarah/yq /usr/bin/yq /usr/bin/yq
 
 # copy and run the build script
 COPY build.sh /tmp/build.sh
 RUN chmod +x /tmp/build.sh && /tmp/build.sh
 
+# clean up and finalize container build
 RUN rm -rf \
         /tmp/* \
         /var/* && \