diff --git a/hooks/post_push b/hooks/post_push
index 63c44e2..6127c1c 100755
--- a/hooks/post_push
+++ b/hooks/post_push
@@ -17,6 +17,13 @@
 # specific language governing permissions and limitations
 # under the License.
 
+# This script makes sure that when a tag is build, it is also pushed
+# to the 'latest' tag, so that 'docker run apache/sling' always uses
+# the latest release
+#
+# see https://docs.docker.com/docker-hub/builds/advanced/
+
+
 if [[ ${DOCKER_TAG} =~ ^[0-9]+$ ]] ; then
     echo "Detected tag build, pushing to 'latest' tag"
     docker tag ${IMAGE_NAME} ${DOCKER_REPO}:latest
diff --git a/hooks/pre_build b/hooks/pre_build
index 49a4f4d..1a533b1 100755
--- a/hooks/pre_build
+++ b/hooks/pre_build
@@ -17,4 +17,9 @@
 # specific language governing permissions and limitations
 # under the License.
 
+# Since the top-level Dockerfile expects the project to be already be built, we hook
+# in the DockerHub build process and replicate the build using docker
+# 
+# see https://docs.docker.com/docker-hub/builds/advanced/
+
 docker run --rm -v "$(pwd)":/build -w /build maven:3.8-openjdk-11 mvn -B package